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1.  INTRODUCTION  :  SAP  SIMULATION  HOST  CSCI 
1.1  BACKGROUND 

The  Semi-automated  Forces  (SAP)  system  provides  the  means  of  incorporating  unmanned 
simulations  of  vehicles  into  a  large-scale  battle  training  simulation;  therefore,  it  allows  for  a 
realistic  representation  of  enemy  forces,  as  well  as  portions  of  friendly  forces,  without 
requiring  human  crews  to  operate  each  component  of  these  forces,  thus  eliminating  the 
ne^  for  excessive  numbers  of  personnel.  These  intelligent,  computer-operated 
participants,  called  SAP  vehicles,  behave  realistically  enough  that  observers  on  the  network 
are  unable  to  distinguish  them  from  manned  simulations.  The  SAP  system  provides 
command  and  control  for  up  to  a  battalion  of  Semi-automated  vehicles. 

Since  the  detailed  simulation  of  many  realistic  vehicles  is  a  computationally  intensive  task, 
the  SAP  system  is  typically  partitioned  across  several  processing  platforms.  One  platform 
provides  the  user  interface  and  another  provides  the  vehicle  simulation.  This  division  is 
reflected  in  the  software  interface  organization  depicted  in  Figure  1.2-1. 

The  SAP  Simulation  Host  (Simhost)  CSCI  (Computer  Software  Configuration  Item) 
simulates  the  SAP  vehicles  and  units.  It  receives  commands  from  one  or  more 
workstations  for  the  initialization,  command,  and  control  of  SAP  units.  It  simulates  the 
vehicles  and  units  interacting  with  each  other  and  the  environment,  and  executes  their 
received  commands.  In  addition,  the  SAP  Simhost  CSCI  monitors  the  activities  of  remote 
vehicles  simulated  by  other  computers  connected  to  the  SIMNET  Local  Area  Network 
(LAN),  and  simulates  the  interactions  between  these  remote  vehicles  and  the  locally 
simulated  vehicles.  It  also  sends  packets  out  on  the  SIMNET  LAN  describing  the  state  of 
the  locally  simulated  vehicles  and  the  interactions  with  the  remote  vehicles. 


1.2  EXTERNAL  INTERFACES 

Figure  1.2-1  depicts  the  software  interface  organization  of  the  SAP  Sim  Host  CSCI  [8.0] 
with  the  SAP  Workstation  CSCI  [6.0]  and  the  SAP  Parameter  Editor  CSCI  [7.0]. 

The  SAP  Simhost  CSCI  provides  an  interface  between  the  SAP  Segment  and  the  SIMNET 
System  via  the  SIMNET  6.6  Protocol.  This  protocol  is  not  significantly  different  from  the 
SIMNET  6.0  Protocol  documented  in  BBN  Report  No.  7102,  titled  "The  SIMNET 
Network  and  Protocols." 

The  SAP  Simhost  CSCI  [8.0]  interfaces  with  the  SAP  Workstation  CSCI  [6.0]  via  the 
SAP  Command  Protocol.  This  protocol  is  described  in  the  SAP  Command  Protocol 
Appendix,  Appendix  A  in  the  SAP  Workstation  CSCI. 

The  SAP  Simhost  CSCI  [8.0]  interfaces  with  the  SAP  Parameter  Editor  CSCI  [7.0]  via  the 
SAP  parameter  files.  These  files  are  described  in  the  SAP  Parameter  Files  Appendix, 
Appendix  B  in  the  SAP  Workstation  CSCI. 
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Figure  1.2-1:  Software  Interface  Organization 

In  addition,  the  SAF  Simhost  CSCI  shares  a  terrain  database  with  the  other  SIMNET 
Segments.  The  terrain  representation  used  by  the  SAF  Simhost  CSCI  is  documented  in  the 
SAF  Terrain  Files  Appendix. 


1.3  INTERNAL  STRUCTURE 

Chronologically,  the  development  of  the  SAF  system  post-dates  the  development  of  the 
vehicle  simulation  software.  Several  of  the  CSCs  that  compose  the  SAF  Simhost  CSCI  are 
shared  with  other  SIMNET  systems. 

The  structure  of  the  SAF  Simhost  CSCI  [8.0]  is  shown  in  Figure  1 .3- 1 .  Tliere  are  1 5  top- 
level  CSCs. 
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Figure  1.3*1:  SAF  Simhost  CSCI  Structure 


1.4  CONFIGURATION  AND  CONFIGURATION  MANAGEMENT 

The  SAF  Simhost  CSCI  is  written  in  the  C  programming  language  and  executes  on  the 
SAF  Simhost  HWCI,  currendy  a  MIPS  2000  computer.  It  executes  under  the  MIPS 
RISC/os  operating  system  (a  UNIX  variant  based  on  AT«&T  System  5  with  Berkeley 
extensions).  The  code  for  the  SAF  Simhost  CSCI  has  been  written  to  maximize  portability 
across  UNIX  computers.  Variants  of  this  code  minus  the  SIMNET  LAN  interface  have 
been  run  on  SUN  and  Silicon  Graphics  computers.  Portions  of  the  SIMNET  interface 
code  run  on  an  intelligent  network  controller  (CMC  ENPlOO  VME  card,  with  68020 
processor). 


3 


BBN  Systems  and  Technologies 


SAF  Simulation  Host  CSCI 


1.5  TERMINOLOGY  AND  DOCUMENTATION 

CIS 

Combat  Instmction  Set 

CM 

Control  Measure 

CSC 

Computer  Software  Component 

CSCI 

Computer  Software  Configuration  Item 

csu 

Computer  Software  Unit 

LAN 

Local  Area  Network 

IVIS 

Inter-vehicular  Interface  System 

MCC 

Measurement,  Command  and  Control 

OPORDERS 

Operations  Orders 

PAE 

Position,  Appearance  and  Echelon 

RUDP 

Reliable  UDP 

SAF 

Semi-automated  Forces 

sbx 

Symbolics  (Computer) 

Simhost 

Simulator  Host 

SIMNET 

Simulation  Network 

UDP 

User  Datagram  Protocol 

VAP 

Vehicle  Appearance  Packets 
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2 .  CSC  DESCRIPTIONS 

The  SAP  Simulation  Host  CSCI  [8.0]  contains  15  top  level  CSCs.  They  are  listed  in 
Pigure  1.3-1. 

2.1.  INITIALIZATION  CSC 

The  initialization  code  starts  up  the  Simhost  CSCI.  It  processes  the  command  line 
switches,  initializes  global  variables,  loads  the  parameter  and  terrain  files,  connects  to  the 
SIMNET  interface  controller,  opens  sockets  forcOTimunications  with  SAP  Workstation 
CSCIs  and  then  starts  up  the  scheduler.  The  scheduler  does  not  return  to  the  operating 
sysytem.  Exit  only  occurs  via  the  SIGINT  signal  (exit(0)). 

The  top  level  Initialization  CSC  has  three  secondary  level  CSCs,  as  shown  in  Pigure  2.1-1: 
the  library  libreader  [8.1.1],  which  reads  the  parameter  files;  the  Parameters  CSC  [8.1.2], 
which  handles  the  symbol  definition  and  storage;  and  the  Initialization  CSC  [8.1.3],  which 
contains  the  global  variable  definitions,  startup  programs,  and  version  information. 


Figure  2.1-1:  Initialization  CSC  Structure 
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2.1.1  libreader  CSC 

/simnet/libsrc/libreader 

This  library  handles  the  reading  of  the  parameter  files  for  use  by  the  Simhost  program. 
Figure  2.1-2  depicts  the  five  CSCs  and  CSUs  contained  in  the  libreader  CSC. 


Figure  2.1-2;  libreader  CSC  Structure 
2. 1.1.1  parser.y  CSC 

/simnet/libsrc/libreader/parser.y 

This  CSC  contains  the  yacc  sources  to  build  the  parser.  It  contains  seven  CSUs,  sho  wn  in 
Figure  2.1-3  depicting  the  structure  of  the  parser.c  CSC. 


Figure  2.1-3:  parser.)  Sti  licture 
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2. 1.1. 1.1  stack_push  CSU 

The  CSU  allocates  a  new  cell,  sets  its  data  value,  and  pushes  it  onto  the  passed  stack. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

data  ptr 

pointer  to  a  DATA  UNION 

Sec.  2.1. 1.5 

stack  ptr 

pointer  to  a  READER  STACK 

Sec.  2. 1.1. 5 

ReturnValues 

Return  Value 

Type 

Meanina 

new  stack 

pointer  to  READER  STACK 

Pointer  to  last  stack  built 

Calls 

Function 

Where  Described 

ALLOCATOR 

Sec.  2. 1.1. 5  See  Appendix  A 

Table  2.1-1:  stack_push  CSU  [8.1. 1.1.1] 


2. 1.1. 1.2  stack_push_array  CSU 

This  CSU  pushes  the  array  of  DATA_UNIONs  onto  the  READER_STACKs. 


Parameters 


Parameters 

Where  Typedef  Declared 

arr 

pointer  to  a  DATA  UNION 

Sec.  2. 1.1. 5 

stack  ptr 

pointer  to  a  READER  STACK 

Sec.  2.1. 1.5 

1  ReturnValues  I 

Return  Value 

Type 

Meanina 

stack  ptr 

READER  STACK 

The  last  stack  pointer 

1  Calls  1 

Function 

Where  Described 

stack  push 

Sec.  2. 1,1. 1.1 

Table  2.1-2:  stack_push_array  CSU  [8.1. 1.1.2] 


2. 1.1. 1.3  free_stack  CSU 

This  CSU  frees  READER_STACK  memory  provided  there  are  more  stacks  (pointers)  to 
free. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

stack  pointer 

pointer  to  READER  STACK 

Sec.  2.1. 1.5 
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Function 


free  stack 


DEALLOCATE 


Calls 


Where  Described 


Sec.  2.1. 1.1. 3 


Sec.  2. 1.1. 5  See  ADoendix  A 


Table  2.1-3:  free  stack  CSU  [8.1.1.1.3] 


2. 1.1. 1.4  make_array  CSU 

The  CSU  determines  the  number  of  DATA_UNION  structures  required  and  requests 
enough  memory  to  make  this  array.  It  then  transfers  the  READER_STACK  pointer  to  the 
DATA_UNION  pointers  via  a  call  to  copy_stack_to_array. 


Parameters 


stack  DOinter 


Return  Value 


result 


Function 


ALLOCATOR 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  READER  STACK  Sec.  2. 1.1. 5 


Ills 


Return  Values 


intertoDATA  UNION 


Meanin 


Where  array  is  finished 


Calls 


Where  Described 


Sec.  2. 1.1. 5  See  ADoendix  A 


Sec.  2.1. 1.1. 5 


Table  2.1-4:  make_array  CSU  [8.1.1.1.41 


2. 1.1. 1.5  copy  stack  to  array  CSU 

This  CSU  copies  pointers  from  the  READER_STACKs  to  the  DATA_UNtONs  until  it 
exhausts  the  number  of  READER  STACKs. 


Parameters 


s 


Return  Value 


next  Dos+1 


Function 


DEALLOCATOR 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  READER  STACK  Sec.  2. 1.1. 5 


inter  to  DATA  UNION  |Sec  2.11.5 


ReturnValues 


e 


intertoDATA  UNION 


intertoDATA  UNION 


Meanin 


Next  point  to  stuff 


Out  of  reader  stack 


Calls 


Where  Described 


Sec.  2. 1.1. 1.5 


Sec.  2. 1.1. 5  See  Appendix  A 


C(»>.  v  stih  k  f«)  art  u'  CSl  [8. 1.1.  i. 5] 


Tabu  2.U,=: 
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2. 1.1. 1.6  yyerror  CSU 

This  CSU  prints  a  parsing  error  message  including  file  name,  line  number,  and  error.  The 
parameter  passed  is  a  pointer  to  the  error  message. 


1  Parametars  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

Table  2.1-6:  yyerror  CSU  [8.1. 1.1.6] 


2. 1.1. 1.7  reader_read_filc  CSU 

The  CSU  reader_read_file  invokes  the  parser  on  the  file  named  fname,  and  puts  the  results 
of  parsing  into  the  DATA_UN10N  pointed  to  by  du. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

fname 

pointer  to  char 

Standard 

du 

pointer  to  Data  Union 

Sec.  2.1. 1.5 

1  ReturnVaiues  1 

Return  Value 

Meaning 

1 

int 

Successful 

0 

int 

Error  (see  below) 

I  Errors  I 

■  Error  Name 

Reason  for  Error 

Cam  open  file,  or  error  condition  occurred  during  parsing 

Table  2.1-7:  reader  read  file  CSU  [8.1. 1.1.7] 


2. 1.1. 2  lexer.l  CSU 

/simnet/libsrc/libreader/lexer.l 

This  CSU  contains  the  lex  sources  to  build  the  lexer,  including  both  the  definitions  for  the 
symbols  read  and  the  actions  taken  based  on  the  definition  encountered. 


2. 1.1. 3  symbol.c  CSC 

/simnet/libsrc/libreader/symbol.c 

This  CSC  contains  the  symbol  table  utility.  Which  version,  if  any,  of  each  CSU  compiled 
within  this  file  depends  on  whether  NO_SYMBOLS  is  defined  as  an  option  of  the 
Makefile. 
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Figure  2.1*4:  symbol.c  CSC  Structure 

In  addition  to  the  seven  CSUs,  symbol.c  contains  a  structure  tagged  bucket_entry  and  three 
constant  definitions  required  by  the  CSU  Do_Hash,  Sec.  2. 1.1. 3.5.  (See  the  following 
two  tables.)  These  are  only  compiled  on  the  condition  that  NO_SYMBOLS  is  undefined  as 
an  option  of  the  Makefile,  which  mean  that  symbols  are  used. 


Item 

Where  Type  Defined 

symbol 

pointer  to  char 

Standard 

next 

pointer  to  struct 

BUCKET  ENTRY 

This  structure  tag 

Table  2.1-8:  BUCKET_ENTRY  Structure  Definition 

The  BUCKET_ENTRY  structure  contains  a  pointer  to  the  current  string  and  a  pointer  to  the 
next  entry.  Following  the  structure  is  the  definition  that  the  pointer  to  the  symbol  table 
array  (symbol_table[SYMBOL_TABLE_SIZE])  is  a  static  BUCKET.ENTRY 


Constant 

Value 

MAX  HASH  CHARS 

5 

LENGTH  MULTIPLIER 

5 

SHIFT  AMOUNT 

2 

Table  2.1-9:  symbol.c  Constant  Definitions 


2. 1.1. 3.1  init_symbol_table  CSU 

This  CSU  initializes  the  symbol  table.  It  is  only  compiled  on  the  eonJition  that 
NO_SYMBOl,S  is  undefined  as  an  option  of  the  Makefile. 


Id 
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2. 1.1. 3. 2  get_symboI  CSU 

This  CSU  finds  the  symbol  in  the  symbol  table  that  matches  the  string  "s".  It  makes  a  new 
entry  if  no  is  found.  It  returns  a  pointer  to  the  string. 


The  CSU  Do_Hash  is  called  only  in  the  version  of  get_symbol  that  is  compiled  on  the 
condition  that  NO_SYMBOLS  is  undefined  as  an  option  of  the  Makefile. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meanina 

bucket->symbol 

pointer  to  char 

If  NO  SYMBOLS  undefined 

copy 

pointer  to  char 

If  NO  SYMBOLS  defined 

Calls 

Function 

Where  Described 

Do  Hash 

Sec.  2. 1.1. 3.5 

ALLOCATOR 

Sec.  2. 1.1. 5  See  Appendix  A 

Table  2.1>10:  get_symboI  CSU  [8.1. 1.3.2] 


2.1. 1.3.3  get_string  CSU 

The  CSU  get_symbol  is  called  only  in  the  version  of  get_string  that  is  compiled  on  the 
condition  that  NO.SYMBOLS  is  undefined  as  an  option  of  the  Makefile;  otherwise,  the 
version  of  get_string  that  uses  the  macro  ALLCXTATOR  is  used.  In  either  condition  (with 
or  without  symbols),  the  CSU  gets  a  copy  of  the  string  pointed  to  by  the  CSU  parameter 
and  returns  a  pointer  to  the  copy  of  the  string. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

1  ReturnValues  1 

Return  Value 

Meaning 

get  symboKs  no  guotes+1) 

pointer  to  char 

pointer  to  copy  of  string 

copy 

pointer  to  char 

pointer  to  copy  of  string 

1  Calls  1 

Function 

Where  Described 

get  symbol 

Sec.  2. 1.1. 3.2 

ALLOCATOR 

Sec.  2. 1.1.5  See  Appendix  A 

Table  2.1-11:  get_string  CSU  [8.1. 1.3.3] 
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2. 1.1. 3. 4  descnbe_symboI_table  CSU 

This  CSU  is  compiled  on  the  condition  that  NO_SYMBOLS  is  undefined  as  an  option  of 
the  Makefile.  This  CSU  calculates  and  prints  a  hash  table  summary,  returning  the  number 
of  entries  per  bucket.  It  also  prints  a  symbol  table  if  the  input  parameter  "printp"  is  true. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

printp 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Meaning  I 

sym  count/bucket  count 

double 

■ . .  . . . 

Table  2.1-12:  describe_syinboI_table  CSU  [8.1. 1.3.4] 


2. 1.1. 3. 5  Do_Hash  CSU 

This  CSU  is  compiled  on  the  condition  that  NO_SYMBOLS  is  undefined  as  an  option  of 
the  Makefile.  It  generates  a  hash  index  and  places  it  into  the  symbol  table  based  on  the 
string  passed. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

String  Ptr 

pointer  to  char 

Standard 

String  length 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

Value 

int 

hash  index  into  the  symbol 
table 

Table  2.1-13:  Do_Hash  CSU  [8.1. 1.3.5] 


2. 1.1. 3. 6  get_symbo|_value  CSU 

If  NO_SYMBOLS  is  defined,  this  CSU  returns  a  NULL  pointer;  otherwise,  it  returns  the 
macro  value  associated  with  the  symbol. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

1  ReturnValues  I 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  DATA  UNION 

NO  SYMBOLS  defined 

({DATA  UNION  **) 
(S-(Sizeof(DATA  UNION*)))) 

pointer  to  DATA_UNION 

Table  2.1-14-  get_symbol  value  CSU  [8. 1.1. 3.6] 
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2. 1.1. 3. 7  set_symbol_value  CSU 

This  CSU  associates  a  macro  value  with  a  symbol  name. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 

V 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Table  2.1-15:  set_symbol_vaIue  CSU  [8.1. 1.3.7] 


2.1. 1.4  tags.c  CSC 

/simnet/libsrc/libreader/tags.c 

This  CSC  contains  the  tagged  array  lookup  CSUs.  The  structure  of  the  tags.c  CSC, 
containing  seven  CSUs,  is  depicted  in  Figure  2.1-5. 


(find_tag_sorted  ^ 

CSU8~1.1.4.7  J 


Figure  2.1-5:  tags.c  CSC  Structure 


2.1. 1.4.1  is_probably_a_string  CSU 

This  CSU  is  used  in  error  message  generation  to  determine  if  a  pointer  likely  points  to  an 
ASCII  string. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  char 

Standard 
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1  ReturnValues  1 

Return  Value 

Meaning 

0 

static  int 

(S«0) 

static  int 

Table  2.1-16:  is_probably_a_string  CSU  [8.1. 1.4.1] 


2. 1.1. 4. 2  tag_error  CSU 

This  CSU  reports  that  a  tag  was  not  found  in  the  passed  table. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

tag 

pointer  to  char 

Standard 

table 

poiunterto  DATA  UNION 

Sec.  2.1. 1.5 

taaaed 

int 

Standard 

errlevel 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

is  probably  a  strinq 

Sec.  2.1. 1.4.1 

Table  2.1-17:  tag^error  CSU  [8.1.1.4.2] 


2. 1.1. 4. 3  findjag  CSU 


This  CSU  uses  a  linear  search  through  the  table,  a  DATA_UNION  array,  (skipping  the 
first  entry  if  this  entry  is  tagged  TABLE_TAGGED)  until  it  finds  the  entry  that  has  “tag”  as 
its  first  element. 


There  are  three  error  levels  possible,  as  passed  by  the  error_level  parameter.  In  all  cases 
the  return  is  zero.  Their  descriptions  are  presented  in  Table  2.1-19. 


Error  Level 

Meaning 

TAGS  NO  ERRORS 

Do  not  report  errors 

TAGS  REPORT  ERRORS 

Report  lag  not  found”  errors 

TAGS  ERRORS  WITH  CONTEXT 

Report  "tag  not  found"  errors  and  give  examples  of  the 
tags  which  were  compared  against 

Table  2.1-18:  find_tag  Error  Levels 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

tag 

pointer  to  char 

Standard 

table 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

tagged 

int 

Standard 

error__level 

int 

Standard 
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1  ReturnValues  1 

Return  Value 

Meaning 

entry 

pointer  to  DATA_UNION 

The  entry  where  tag  was 
found 

0 

pointer  to  DATA  UNION 

Taq  not  found 

1  Calls  1 

Function 

Where  Described 

symbols  match 

Sec.  2. 1.1. 5 

taa  error 

Sec.  2. 1.1. 4.2 

Table  2.M9:  findjag  CSU  [8.1.1.4.3] 


2. 1.1. 4. 4  cmp_tags  CSU 

This  CSU  returns  a  value  greater  than,  equal  to,  or  less  than  zero  depending  upon  whether 
the  first  passed  symbol  is  considered  greater  than,  equal  to,  or  less  than  the  second  in 
sorting. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

duO 

pointer  to  DATA  UNION 

Sec.  2. 1.1.5 

dul 

pointer  to  DATA  UNION 

Sec.  2.1.1 .5 

ReturnValues 

Return  Value 

Type 

Meaning 

-1 

static  int 

First  passed  symbol  is  less 
than  the  second  in  the  strinq 

1 

static  int 

First  passed  symbol  is  greater 
than  the  second  in  the  strinq 

0 

static  int 

First  passed  symbol  is  equal  to 
the  second  in  the  strinq 

Calls 

Function 

Where  Described 

symbol  compare 

Sec.  2. 

Table  2.1-20:  cmp_tags  CSU  [8.1. 1.4.4] 


2. 1.1. 4. 5  sort_tag_tabIe  CSU 

This  CSU  uses  qsort  to  sort  the  specified  "table"  (skipping  the  first  entry  if  this  entry 
"tagged"  is  tag  itself),  keyed  by  the  "tag"  of  each  entry. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

table 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

taqqed 

int 

Standard 
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1  Calls  1 

Function 

Where  Described 

qsort 

Sec.  2. 

Table  2.1-21:  sort_tag_table  CSU  [8.1. 1.4.5] 


2. 1.1. 4. 6  binarysearch_tag  CSU 

This  CSU  conducts  a  recursive  binary  search  for  the  tag  in  the  passed  table. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

kev 

pointer  to  char 

Standard 

first 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

last 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

1  ReturnValues  1 

Return  Value 

Type 

Meanlnq 

NULL 

static  pointer  to  DATA  UNION 

first 

static  pointer  to  DATA  UNION 

last 

static  pointer  to  DATA  UNION 

binarysearch  taq 

static  pointer  to  DATA  UNION 

1  Calls  1 

Function 

Where  Described 

symbols  compare 

Sec.  2.1. 1.5 

Sec.  2.1. 1.4.6 

Table  2.1*22:  binarysearch_tag  CSU  [8. 1.1. 4.6] 


2. 1.1. 4. 7  rind_tag_sorted  CSU 

This  CSU  searches  through  the  table  (skipping  the  first  entry  if  this  entr>  '  tagged  is  table 
tagged)  until  it  finds  the  entry  that  has  "tag"  as  its  first  element.  It  is  similar  to  find_tag 
except  that  the  table  is  presumed  to  be  sorted.  Thus,  it  uses  a  binan'  search 
(binarysearch_tag)  rather  than  a  linear  one. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

taq 

pointer  to  char 

Standard 

table 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

ESHjlsSSliiHHIliHHHiHii 

int 

Standard 

1  errievel 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

result  ->  array 

pointer  to  DATA  UNION 

0 

pointer  to  DATA  UNION 

taq  error 
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1  Calls  1 

Function 

Where  Described 

binarysearch  tap 

Sec.  2.1. 1.4.6 

taq  error 

Sec.  2.1. 1.4.2 

Table  2.1-23:  rind_tag_sorted  CSU  [8.1.1.4.7] 


2. 1.1. 5  libreader.h  CSU 

/simnet/libsrc/libreader/libreader.h 

This  header  file  CSU  contains  external  CSU  defines,  a  typedef  union,  a  typedef  struct,  five 
tag  constants,  a  symbol  table  size  constant,  and  condition^  macro  defines.  The  macros  are 
in  Appendix  A. 

The  following  typedef  union  is  tagged  data_union. 


Item 

Where  Type  Defined 

charptr 

pointer  to  char 

Standard 

inteqer 

int 

Standard 

real 

float 

Standard 

array 

pointer  to  a  union  data  union 

This  union  structure 

Table  2.1-24:  DATA_UNION  Union  Definition 

The  following  typedef  struct,  used  only  for  parsing,  is  tagged  stack.  Note  that  "next" 
points  to  the  next  stack. 


item 

Type 

Where  Type  Defined 

data 

DATA  UNION 

Union  above  this  definition 

next 

pointer  to  struct  stack 

This  structure 

Table  2.1-25:  READER_STACK  Structure  Definition 
The  following  table  contains  the  TAGS  and  TABLE_TAGGED  constants. 


Constant 

Value 

TAGS  NO  ERRORS 

0 

TAGS  REPORT  ERRORS 

1 

TAGS  ERRORS  WITH  CONTEXT 

2 

TABLES  NOT  TAGGED 

0 

TABLES  TAGGED 

1 

Table  2.1-26:  TAGS  and  TABLE  TAGGED  Constant  Definitions 
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The  following  symbol  table  size  constant  is  predicated  on  the  size  not  having  been 
previously  defined.  This  would  occur  as  part  of  the  Makefile  for  the  library. 


Constant 

Value 

SYMBOL  TABLE  SIZE 

947 

Table  2.1.27:  SYMBOL_TABLE_SIZE  Constant  DeHnition 


2.1.2  Parameters  CSC 

This  CSC  defines  and  initializes  the  Simhost  code  symbols  (list  of  parameters).  It  consists 
of  the  symbols.c  CSC  and  symbols.h  CSU,  as  seen  in  the  structure  depicted  in  Figure 
2.1-6. 


init_global  symbols 
CSU  8.r.2.1.1 


c 


symbols.h 
CSU  8.1 .2.2 


Figure  2.1-6:  Parameters  CSC  Structure 

2. 1.2.1  symbols.c  CSC 

/simnet/src^ost/symbol  s .  c 

The  file  contains  a  single  CSU,  init_global_symbols.  It  acts  as  the  storage  location  for  the 
symbols  (common  strings  stored  in  a  shared  area)  used  in  the  Simhost  code,  and  also 
handles  initializing  the  symbols 

2. 1.2. 1.1  init  global  synibols  CSU 

This  CSU  initializes  the  *_SYM  symbols  to  their  character  string  values  for  the  other  I'iIcn 
composing  the  Simhost  code. 


1  Calls  1 

Function 

Where  Described  I 

get  symbol 

Sec.  2. 1.1. 3.2  I 

Table 

2.1-28 

init  global  symboLs  CSU  [8.1  2  1.1 1 

IS 
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2. 1.2.2  symbols.h  CSU 
/simnet/src/host/symbols.h 

This  CSU  defines  the  symbols  for  the  other  files  composing  the  Simhost  code. 


2.1.3  Initialization  CSC 

This  CSC  provides  the  initialization  of  the  Simhost  program.  It  consists  of  the  main.c  CSC 
and  the  version.c  CSC.  The  structure  of  the  Initialization  CSC  is  depicted  in  Figure  2.1-7. 


I 


Figure  2.1-7:  Initialization  CSC  Structure 
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2. 1.3.1  main.c  CSC 

/simnet/src/host/main.c 


This  CSC  contains  the  definitions  for  the  global  variables  used  throughout  the  pro^m.  It 
also  contains  the  code  to  initialize  the  various  systems  and  data  structures  used  during  the 
execution  of  the  program.  This  initialization  includes  loading  data  files,  creating  tables, 
starting  clocks  and  the  scheduler,  and  initializing  the  terrain  ^tabase.  Other  items  included 
in  this  file  are  CSUs  to  monitor  the  performance  level  of  the  program  and  handle  overload 
situations,  the  code  to  handle  arguments  at  program  start  up  time,  the  program  abort 
handler,  and  of  course,  the  CSU  main. 


2. 1.3. 1.1  gasp  CSU 


1  Calls  1 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

write  buffer  all  sbx 

Sec.  2.4.3  2.3 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.1-29:  gasp  CSU  [8.1.3.1.1] 

2.1.3. 1.2  sigh  CSU 

The  sigh  CSU  prints  a  "Sigh.  All  better"  message  to  the  screen. 

2. 1.3. 1.3  init_stuff  CSU 

This  CSU  calls  other  initialization  routines  in  the  proper  order. 


1  ReturnValues  1 

Return  Value 

Meaning 

SUCCESS 

int 

initialization  succeeded 

1  Calls  1 

Function 

Where  Described 

heap  create 

Sec.  2.14.2.2.2 

exit  handler 

Sec.  2.1.3.1.21 

init  clocks 

Sec.  2.14.3.3.1 

scheduler  init 

Sec  2.2.1.3.1 

set_critical_performance_ 

level 

Sec.  2.2. 1.4.3 

init  symbol  table 

Sec,  2.1.1.31 

init  safobj  table 

Sec.  2.2.2. 1 

init  saf  to  simnet  id  table 

FORCE  OUT 

Sec.  2.5  2.2 

init  global  symbols 

Sec.  2. 1.2.2 

database  init 

Sec.  2. 1.3. 1.6 

init  terrain  stuff 

Sec  2. 1.3. 1.5 

read  machine  file 

Sec.  2. 1.3. 1.4 

Tabic  2.1-30;  init  .sinff  (  SI  (8.1.3.1.31 
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2. 1.3. 1.4  read  machine  file  CSU 


This  CSU  reads  machine-specific  information  and  stores  it  in  global  variables. 


1  Calls  1 

Function 

Where  Described 

reader  read  file 

Sec.  2.1. 1.1 .7 

ERROR  OUT 

Sec.  2.5.2.2 

find  taa 

Sec.  2.1. 1.4.3 

aet  symbol 

Sec.  2. 1.1. 3.2 

open  io  connections 

Sec.  2.4.3.1 

FORCE  OUT 

Sec.  2.5.2.2 

Table  2.1-31:  read_machine_file  CSU  [8.1.3.1.4] 


2. 1.3. 1.5  init_terrain_stuff  CSU 

This  CSU  calls  terrain-related  initialization  routines. 


1  Errors  I 

Error  Name 

Reason  for  Error 

ERROR  OUT 

Unable  to  initiate  terrain 

Calls 

Function 

Where  Described 

FORCE  OUT 

Sec.  2.5.2.2 

read  quadtree  database 

Sec.  2.12.1.1.1 

tdb  init  cache 

Sec.  2.21.7.27.1  in  MCC  CSCI  SDD 

tdb  error 

Sec.  2.21.7.17.1  in  MCC  CSCI  SDD 

ERROR  OUT 

Sec.  2.5.2.2 

tdb  init  memory 

Sec.  2.21.7.25.1  in  MCC  CSCI  SDD 

tdb  init  patch  guards 

Sec.  2.21 .7.10.4  in  MCC  CSCI  SDD 

tdb  aet  db  name 

Sec.  2.21.7.15.19  in  MCC  CSCI  SDD 

init  grid  tables 

Sec.  2.9.3.1.10 

Table  2.1-32:  init  terrain  stuff  CSU  [8.1.3.1.5] 


2. 1.3. 1.6  database_init  CSU 

This  CSU  initializes  global  variables. 


1  Calls  1 

Function 

Where  Described 

reader  read  file 

Sec.  2. 1.1. 1.7 

database  read 

Sec.  2.6.8.8.1 

sort  form  db 

Sec.  2.8.1.4.12 

init  mappings 

Sec.  2.4  3.1. 1 

Table  2.1-33:  database  init  CSU  [8.1.3.1.6] 
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2. 1.3. 1.7  debugging_on  CSU 

This  CSU  sets  all  debugging  flags  on,  except  event  debugging,  and  prints  "Debugging  is 
now  on." 


2. 1.3. 1.8  print_cominands_froin_sbx  CSU 

This  CSU  sets  g_print_commands  to  TRUE  and  prints  "Printing  command  from  SBX." 

2. 1.3. 1.9  set_terrain_dbase  CSU 
This  CSU  sets  the  terrain  database  to  load. 


1  Parameters  1 

jPaiameters 

Type 

Where  Typedef  Declared 

1  dbase 

pointer  to  char 

Standard 

Table  2.1-34:  set_terrain_dbase  CSU  [8.1.3.1.9] 


2.1.3.1.10  set_tdb_to_cache  CSU 

This  CSU  enables  caching  (versus  loading  the  entire  object  into  memory). 

2.1.3.1.11  network^silent  CSU 

This  CSU  disables  use  of  the  SIMNET  LAN  input/output. 

2.1.3.1.12  set_simnet_files  CSU 

This  CSU  is  included  at  compile  time  if  FILE_NET  is  defined.  This  function  is  used  when 
SIMNET  traffic  is  simulated  via  the  NFS  interface. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

filein 

pointer  to  char 

Standard 

fileout 

pointer  to  char 

Standard 

Table  2.1-35:  set_simnet_files  CSU  [8.1.3.1.12] 
2.1.3.1.13  set  exercise  id  CSU 
This  CSU  sets  exercise  to  a  number.  The  default  is  1 . 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

strnum 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5.2  2 

Table  2.1-36:  scf_c\ercise  id  C.Sl 

[8.1.3.1.13] 
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2.1.3.1.14  isolate_connection  CSU 

This  CSU  specifies  that  only  one  port  should  be  opened  for  input. 


1  Parameters  I 

Parameters 

Where  Typedef  Declared 

strnum 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5.3.3 

Table  2.1-37:  isolate_connection  CSU  [8.1.3.1.14] 
2.1.3.1.15  set_target_inachine  CSU 

This  CSU,  included  at  compilation  time  if  BENCHMARK  is  defined,  is  used  only  for 
benchmarking. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

strnum 

pointer  to  char 

Standard 

Table  2.1-38:  set_target_machine  CSU  [8.1.3.1.15] 
2.1.3.1.16  set_number_of_fake_reniotes  CSU 

This  CSU,  included  at  compilation  time  if  BENCHMARK  is  defined,  is  used  only  for 
benchmarking. 


2.1.3.1.17  saf_print_help  CSU 

This  CSU  prints  the  help  menu. 

2.1.3.1.18  BEGIN_ARG_TABLE(SWITCH)  CSU 

This  CSU  consists  of  a  series  of  SWITCH  macros,  defining  the  actions  resulting  from  the 
activation  of  a  switch  following  the  printing  of  the  saf_print_help  CSU  message 


1  Calls  1 

Function 

Where  Described 

SWITCH 

Sec.  2.1.3.1.18 

BREAK  SET 

Table  2.1-39:  BEGIN_ARG_TABLE(SWITCH)  CSU  [8.1.3.1.18] 
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2.1.3.1.19  main  CSU 

This  CSU  calls  the  initialization  routine  and  starts  the  scheduler. 


Parameters 


Parameters 


Where  Tvoedef  Declared 


Standard 


Standard 


ReturnValues 


Return  Value 


Meanin 


completed 


Function 


abort  handler 


Identify  version 


roc  switches 


ERROR  OUT 


init  stuff 


exit  handler 


start  simnet 


arser  create 


invoke  functions  until 


Calls 


Where  Described 


Sec.  2.1.3.1.20 


Sec.  2.1. 3.2.1 


Sec.  2.14.3.1.1 


Sec.  2.5.2.2 


Sec.  2.1. 3.1. 3 


Sec.  2.1.3.1.21 


Sec.  2.3.2.1 


Sec.  2.5  2.1. 3 


Sec.  2.2.1. 5.1 


Table  2.1-40:  main  CSU  [8.1.3.1.19] 


2.1.3.1.20  abort_handler  CSU 

This  CSU  handles  the  abort  signal,  cleans  up  the  system  functions,  and  exits. 


Parameters 


Parameters 


code 


Where  Typedef  Declared 


Standard 


Function 


etpid 


simnet  exit 


exit  all  sbx  conns 


arser  restore  term 


Calls 


Where  Described 


Sec.  2.3.2.7 


Sec.  2.4.3.2  2 


Sec.  2.5.2.1.2 


Sec  2.14.2.2.3 


Table  2.1-41:  abort  handler  CSU  [8.1.3.1.20] 
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2.1.3.1.21  exit_handler  CSU 

This  CSU  handles  the  exit  signal,  cleans  up  the  system  functions,  and  exits. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

code 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

simnet  exit 

Sec.  2.3.2.7 

exit  all  sbx  conns 

Sec.  2.4.3.2  2 

cache  and  file  terminate 

Sec  2.21 .7.7.2  In  MCC  CSCI  SDD 

parser  restore  term 

Sec.  2.5.2.1.2 

heap  destroy 

Sec.  2.14.2.2.3 

Table  2.1-42:  exit  handler  CSU  [8.1.3.1.21] 


2.1.3.1.22  saf_exit  CSU 

This  CSU  calls  two  other  CSUs,  saf_compIete_reset  and  exit_handler,  which  do  the  work 
of  exiting. 


1  Calls  1 

Function 

Where  Described 

saf  complete  reset 

Sec.  2.2.2.3.1 

exit  handler 

Sec.  2.1.3.1.20 

Table  2.1-43:  saf_exU  CSU  [8.1.3.1.22] 


2. 1.3. 2  version.c  CSC 
/simnet/src/host/version  .c 

This  CSC  prints  the  version  information  when  the  Simhost  CSCI  (phantom  program)  is 
started.  Comments  provide  a  brief  history  of  releases. 


2. 1.3.2. 1  identify_version  CSU 

Through  multiple  calls  to  printf  this  CSU  displays  the  current  version  (PHANTOM  3.9.10) 
and  date  (Released  on  8/30/90). 
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2.2  SCHEDULER  CSC 

The  Scheduler  CSC  runs  the  simulation.  To  avoid  the  overhead  of  system  calls  and  to 
make  the  program  more  portable,  the  UNIX  scheduler  is  not  used.  The  scheduler  "ticks" 
the  Parser  Interface  CSC,  the  SIMNET  Interface  CSC,  the  SAP  Command  Interface  CSC, 
the  Local  Vehicles  CSC,  the  Remote  Vehicles  CSC,  and  the  Units  CSC,  thus  running  the 
entire  simulation  and  the  external  interfaces. 

Each  "tick"  is  an  elapse  of  time.  The  time  between  ticks,  or  scheduled  updates  for  a 
function,  depends  on  the  periodic  rate  or  next  time  of  operation  for  that  function.  The 
scheduler  compares  the  next  time  of  function  operation  with  the  present  time,  and  if  the 
present  time  is  past  the  scheduled  time,  the  CSU  code  is  executed. 

The  top  level  Scheduler  CSC  consists  of  four  secondary  level  CSCs:  libsched  CSC, 
safobj.c  CSC,  tickable.c  CSC,  and  saf.c  CSC.  The  Scheduler  CSC  structure  is  depicted  in 
Pigure  2.2-1. 


Figure  2.2-1:  SCHEDULER  (  S(  Structure 
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2.2.1  libsched  CSC 
/simnet/libsrc/libsched 

This  library  handles  the  scheduler,  which  calls  functions  when  their  time  to  execute  occurs. 
Whether  a  function  is  called  is  determined  by  checking  the  time  for  the  next  execution  of  the 
function  in  the  scheduler  rings.  If  the  current  "clock"  time  is  past  that  scheduled  time,  the 
function  is  executed. 


2. 2. 1.1  fncl.c  CSC 


/simnei/libsrc/libsched/fncl.c 

This  CSC  contains  scheduler  entry  point  CSUs.  Its  structure  is  depicted  in  Figure  2.2-2. 


Figure  2.2-2:  fncl.c  CSC  Structure 
2. 2. 1.1.1  deferred  fnci  CSU 


This  CSU  initializes  a  function  which  is  delayed  by  the  period  of  time  passed  in  the  "delay" 
parameter  and  then  executed  once. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

func 

FUNC  PTR 

delay 

unsigned  int 

Standard 

group 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

heap  allocate 

Sec.  2.14.2.2.1 

get  millisecond  time 

Sec.  2.14.3.3.2 

get  args 

Sec.  2.2. 1.1. 3 

insert  function 

Sec.  2.2. 1.3.5 

Table  2.2-1:  deferred  fncI  CSU  18.2.1.1.1] 
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2. 2. 1.1. 2  periodicjnci  CSU 

This  CSU  is  similar  to  deferred_fncl,  except  that  after  the  inital  delay  the  function  is 
executed  on  a  periodic  basis. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

func 

FUNC  PTR 

delay 

unsioned  int 

Standard 

arouD 

int 

Standard 

Calls 

Function 

Where  Described 

heap  allocate 

Sec.  2.14.2.2.1 

oet  millisecond  time 

Sec.  2.14.3.3.2 

oet  aras 

Sec.  2.2. 1.1 .3 

insert  function 

Sec.  2.2. 1.3.5 

Table  2.2-2:  periodic_fncI  CSU  [8.2.1. 1.2] 


2. 2. 1.1. 3  get_args  CSU 

This  CSU,  whose  parameters  consist  of  a  pointer  to  a  functional  description  structure  and  a 
list  of  arguments,  checks  variable  argument  type  for  (and  as  long  as  there  are)  integers  or 
doubles  and  not  the  end  of  the  list  (or  an  unknown  argument  type).  On  each  successful 
check,  it  increments  the  count.  Upon  completion,  it  sets  the  structure's  argument  count, 
gets  memory  to  store  the  arguments,  storing  a  pointer  to  the  memory,  and  copies  the 
arguments  into  memory. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

fd 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1. 6 

Calls 

Function 

Where  Described 

heap_allocate 

Sec.  2.14.2.1.1 

Table  2.2-3:  get  args  CSU  [8. 2. 1.1. 3] 
2. 2. 1.1. 4  cancel  fnci  CSU 


This  CSU  removes  a  functional  description  through  a  call  to  remove.Junction.  If  the  item 
is  currently  executing,  free_when_donc  is  set,  but  if  it  is  not  executing,  the  function  is 
freed  through  a  call  to  free_function. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

id 

int 

Standard 
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1  Calls  1 

Function 

Where  Described 

remove  function 

Sec.  2.2.1. 3.3 

free  function 

Sec.  2.2.1. 3.2 

Table  2.2-4:  cancel  fnci  CSU  [8.2.1.1.4] 


2. 2. 1.1. 5  cancel_fncl_group  CSU 

This  CSU  collects  a  list  of  thing  to  cancel,  first  the  event  rings  and  then  the  functional 
description  groups,  and  then  cancels  them  through  a  call  to  cancel_fncl. 


I  Parameters  1 

Parameters 

Where  Typedef  Declared 

arouD 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

cancel  fncI 

Sec.  2.2. 1.1. 4 

Table  2.2-5;  cancel_fncl_group  CSU  [8.2. 1.1.5] 


2. 2. 1.1. 6  change_fncl_period  CSU 

This  CSU  removes  from  the  scheduler  the  function  whose  id  is  passed.  It  sets  the 
function's  period  to  the  new_period,  and  sets  the  time  that  the  operation  is  to  take  place.  It 
then  inserts  the  function  back  into  the  scheduler. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

id 

int 

Standard 

new  period 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

remove  function 

Sec.  2.2.1. 3.3 

aet  miliisecond  time 

Sec.  2.14.3.3.2 

insert  function 

Sec.  2.2.1. 3.5 

Table  2.2-6:  change_fncl_period  CSU  [8.2.1. 1.6] 
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2.2. 1.2  invoke.c  CSC 
/simnet/libsrc/libschedAnvoke.c 

This  CSC  contains  only  one  CSU,  invoke,  as  shown  in  Figure  2.2-3. 


Figure  2.2-3:  invoke.c  CSC  Structure 


2. 2. 1.2.1  invoke  CSU 

This  CSU  is  the  only  one  within  the  CSC  invoke.c.  Its  purpose  is  to  invoke  a  function,  the 
pointer  to  which  being  passed  as  a  parameter.  Within  the  function  are  five  macro 
definitions,  Cl(tO),  C2(t0,tl),  C3(t0,tl,t2),  C4(t0,tl,t2,t3),  and  S(n,x,y),  which  are 
defined  in  Appendix  A. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

fd 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1. 6 

1  Calls  1 

Function 

Where  Described  I 

S 

. . . 

C1 

C2 

C3 

C4 

free  function 

Sec.  2.2.1. 3.2  1 

Table  2.2-7:  invoke  CSU  [8.2.1.2.1] 


2.2. 1.3  maint.c  CSC 

/sim  net/1  i  bsrc/1  i  bsched/main  t  .c 

This  CSC  consists  of  six  CSUs  required  for  scheduler  maintenance. 


30 


BBN  Systems  and  Technologies 


SAF  Simulation  Host  CSCI 


maint.c 

CSC 

8.2.1. 3 

r  scheduler  init  ^  f  freejunction  f  remove  Junction 

V,  CSU8.2.1T3.I  Jv  CSU  8.2.1 .3.2  J  CSU  8.2.1. 3.3 

c 


insert_periodic_function 
CSU  8.2.1 .3.4 


)C 


insertjfunction 
CSU  8.2.1 .3.5 


)C 


which_event_ring 
CSU  8.2. 1.3.6 


Figure  2.2-4:  maint.c  CSC  Structure 


2. 2. 1.3.1  schedulerjnit  CSU 

This  CSU  gets  and  sets  up  function  description  structures  for  the  number  of  rings  passed, 
as  long  as  Ae  number  is  less  than  the  maximum  number  of  rings  allowed.  It  then  sets  both 
the  event  list  head  and  tail  to  zero  since  neither  position  has  yet  been  filled. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

nrinqs 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

heap  allocate 

Sec.  2.14.2.1.1 

Table  2.2-8:  scheduler  init  CSU  [8.2.1.3.1] 


2.2. 1.3.2  free_function  CSU 

This  CSU  frees  the  memory  heap  used  by  the  function  arguments  and  then  frees  the  heap 
used  by  the  function. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

fd 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1. 6 

Calls 

Function 

Where  Described 

heap._deallocate 

Sec.  2.14.2.1.4 

Table  2.2-9:  free  function  CSU  [8.2. 1.3. 2] 
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2.2. 1.3.3  remov.e_function  CSU 

This  CSU  removes  the  function  from  either  the  event  list  or  the  event  rings.  If  the  function 
was  the  last  function  in  the  lowest  (fastest  period)  occupied  ring,  then  by  definition  the 
lowest  occupied  ring  must  be  a  higher  ring.  The  CSU  then  find  the  ring.  An  error  check  is 
done  at  the  end  to  ensure  integrity  of  the  scheduler  data  structures. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

td 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1. 6 

Calls 

Function 

Where  Described 

which  event  rina 

Sec.  2.2.1. 3.6 

Table  2.2-10:  remove  function  CSU  [8.2.1.3.3] 


2. 2. 1.3. 4  insert_periodic_function  CSU 

This  CSU  determines  into  which  event  ring  the  function  should  be  placed,  and  sets  the 
function  description  structure  accordingly.  If  this  function  is  going  below  the  current 
lowest  occupied  ring,  the  new  lowest  occupied  ring  is  set  to  the  ring  that  the  function 
occupies. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

td 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1 .6 

1  Calls  1 

Function 

Where  Described 

which  event  rinq 

Sec.  2.2.1 .3.6 

Table  2.2-11:  insert_periodic_function  CSU  [8.2. 1.3.4] 


2. 2. 1.3. 5  insert  function  CSU 


This  CSU  insens  a  function  into  the  scheduler  event  list  determined  by  when  the  function 
should  be  scheduled. 


1  Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

fd 

pointer  to 

FUNCTION  DESCRIPTION 

Sec.  2.2.1. 6 

Table  2.2-12:  insert  function  CSU  [8. 2.1. 3. .‘'j 
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2. 2. 1.3. 6  which_event_ring  CSU 

This  CSU  returns  the  event  ring  for  the  period  passed,  if  one  exists. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

period 

unsigned  int 

Standard 

1  ReturnVaiues  1 

Return  Value 

Meaning 

i 

unsigned  short 

Event  ring  for  period  passed 

0 

unsigned  short 

No  event  ring  for  period 

Table  2.2-13:  which_eveiit_ring  CSU  [8.2.1.3.6] 


2.2. 1.4  perf.c  CSC 

/simnet/libsrc/libsched/perf.c 

This  CSC  contains  six  CSUs  required  to  monitor  system  performance.  Its  structure  is 
shown  in  Figure  2.2-5. 


Figure  2.2-5:  perf.c  CSC  Structure 


2. 2. 1.4.1  perf_monitor_on  CSU 

This  CSU  turns  the  performance  monitoring  functions  on,  setting  the  performance 
monitoring  period  to  the  period  passed,  getting  the  clock  time,  and  zeroing  out  the  previous 
performance  statistics. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

period 

unsigned  int 

Standard 
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1  Calls  1 

Function 

Where  Described 

zero  oertormance  stats 

Sec.  2.2.1. 4.4 

aet  millisecond  time 

Sec.  2.14.3.3.2 

Table  2.2- 14:  perf_monitor_on  CSU  [8.2. 1.4.1] 


2. 2. 1.4. 2  perf_monitor_off  CSU 

This  CSU  turns  the  perfomance  monitor  off  by  setting  the  performance  monitor  period  to 
zero. 


2. 2. 1.4. 3  set_critical_performance_level  CSU 

This  CSU  sets  the  critical  performance  levels  for  monitoring  system  performance  by  setting 
these  static  variables  to  the  values  passed:  to  zero  in  the  cases  of  critical_count  and 
critical_total,  to  the  critical_ring  (based  on  a  call  to  which_event_ring,  passing  the  period), 
and  critical_next_check  (a  function  of  the  present  time  plus  for_how_long). 


1  Parameters  I 

Parameters 

Where  Tvpedef  Declared 

period 

unsigned  int 

Standard 

ratio 

double 

Standard 

under  threshold 

unsigned  int 

Standard 

for  how  Iona 

unsigned  int 

Standard 

stress  function 

FUNG  PTR 

relief  function 

FUNG  PTR 

1  Calls  1 

Function 

Where  Described 

which  event  ring 

Sec.  2.2. 1.3.6 

get  millisecond 

Sec.  2,14.3.3.2 

Table  2.2-15:  set_critical_performance_level  CSU  [8. 2. 1. 4. 3] 


2. 2. 1.4. 4  2ero_perf_stats  CSU 

This  CSU  sets  all  the  performance  statistics  to  zero,  sets  the  last  performance  check  for 
each  ring  to  zero,  and  sets  next  print  time  of  the  performance  monitor 
(perf_monitor_next_print)  to  the  sum  of  the  current  clock  time  (passed  as  a  parameter)  plus 
the  performance  monitoring  period  (perf_monitor_period) 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

clock 

unsigned  inf 

Standard 

Table  2.2-16:  zero  perf  slats  CSU  [8. 2. 1.4. 4] 
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2. 2. 1.4. 5  collect_perf_stat  CSU 

This  CSU  collects  performance  statistics.  It  first  checks  if  it  printed  the  statistics  on  the  last 
performance  check,  and  if  so,  sets  that  flag  to  "clock”,  indicating  that  the  skipped  cycle  has 
occurred.  If  the  clock  is  past  the  time  of  waiting  to  print  the  statistics,  the  routine  prints  the 
statistics  and  zeroes  the  performance  statistics.  Depending  on  the  ring  passed  (equivalent  to 
the  critical  ring),  the  clock  (past  the  next  critical  cl^k),  and  the  resulting  critical_count  and 
critical_total,  the  critical_state  may  be  complemented  (zero  to  one  or  one  to  zero). 
Depending  on  the  critical_ratio,  the  critical_stress_function  or  the  critical_relief_function 
may  be  cdled.  The  (DSU  updates  the  time  for  the  next  critical  check  and  sets  both 
critical_count  and  critical_total  to  zero. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

rina 

unsigned  short 

Standard 

clock 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

min 

Sim  macros. h 

print  pert  stats 

Sec.  2.2.1. 4.6 

zero  pert  stats 

Sec.  2.2.1. 4.4 

critical  stress  function 

critical  relief  function 

Table  2.2-17:  collect_perf_stat  CSU  [8.2.1.4.5] 


2.2. 1.4.6  print_performance_stats  CSU 

This  CSU  prints  the  collected  performance  monitoring  statistics. 

2.2. 1.5  sched.c  CSC 

/simnet/libsrc/libsched/sched.c 

In  addition  to  the  two  functions  shown  in  Figure  2.2-6,  the  file  contains  four  event  ring  and 
two  event  list  declarations  and  a  macro  (min3(a,b,c))  described  in  Appendix  A. 


Figure  2.2-6:  sched.c  CSC  Structure 
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2. 2. 1.5.1  invoke_functions_until  CSU 

This  CSU  invokes  functions  in  the  scheduler  rings  until  the  deadline  (passed  in  the  input 
parameter)  occurs. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

deadline 

unsianed  int 

Standard 

I  Calls  1 

Function 

Where  Described 

qet  millisecond  time 

Sec.  2.14.3.3.2 

insert  periodic  function 

Sec.  2.2.1. 3.4 

invoke 

Sec.  2.2.1. 2.1 

collect  perf  stat 

Sec.  2.2.1. 4.5 

min3 

Sec.  2. 2. 1.5  See  Appendix  A 

invoke  functions  until 

Sec.  2.2. 1.5.1 

wait  until 

Sec.  2.2. 1.5.2 

Table  2.2-18:  invoke  functions  until  CSU  [8.2. 1.5.1] 


2. 2. 1.5. 2  wait  until  CSU 


This  CSU  waits  until  the  time  is  at  or  past  the  deadline. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

deadline 

unsiqned  int 

Standard 

1  Calls  1 

Function 

Where  Described 

qet  millisecond  time 

Sec.  2.14.3.3.2 

Table  2.2-19:  wait  until  CSU  [8.2.1.5.21 


2. 2. 1.6  llbsched.h  CSU 

/simnet/libsrc/libsched/libsched.h 

This  include  file,  in  addition  to  a  number  of  external  declarations,  contains  a  number  of 
constant  defines  and  two  structure  definitions  (typedef  struct  ARG_UN10N  and 
FUNCTI0N_DESCR1PT10N),  which  are  described  in  the  following  tables. 
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Constant 

Value 

MAX  RINGS 

8 

PERF  WIDTH 

20 

A  END 

0  r  Arqument  types  */ 

A  INT 

1 

A  DOUBLE 

2 

A  CHAR 

1  /*  Everythinq  else  promoted  to  int  */ 

A  SHORT 

1 

A  FLOAT 

2  /*  or  double  */ 

A  PTR 

1 

ASAP 

0  /*  no  delay  */ 

Table  2.2-20:  libsched.h  Constants 


Item 

Type 

Where  Type  Defined 

taq 

unsiqned  short 

Standard 

[union  | 

int  arq 

int 

Standard 

double  arq 

double 

Standard 

Table  2.2-21:  ARG  UNION  Structure  DeHnition 


Item 

Type 

Where  Type  Defined 

when 

unsiqned  int 

Standard 

func 

FUNC  PTR 

period 

unsiqned  int 

Standard 

marker  :1 

unsiqned  int 

Standard 

executinq  :1 

unsiqned  int 

Standard 

free  when  done  :1 

unsiqned  inf 

Standard 

perkxjk:  :1 

unsiqned  int 

Standard 

arq  count 

short 

Standard 

qroup 

int 

Standard 

arqs 

pointer  to  ARG  UNION 

Above 

prev 

pointer  to  struct 
function  description 

Here,  pointer  to  previous 
structure 

next 

pointer  to  struct 
function  description 

Here,  pointer  to  next  structure 

Table  2.2-22: 


FUNCTION  DESCRIPTION  Structure  Definition 
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2.2.2  safobj.c  CSC 
/simnet/src/host/safobj  .c 

This  CSC  contains  the  CSUs  to  construct  the  object  table  which  is  used  to  track  all  of  the 
locally  simulated  vehicles,  remote  vehicles,  and  units. 

safobj.c 

CSC 

8.2.2 


init  safobitable  l  {  allocata_8afo^  A  [  deallocate_safobj 
CSU  8.2.2 1  J  V  CSU  8.2.2  2  J  CSU  8.2.2.3 

Figure  2.2-7;  safobj.c  CSC  Structure 
2.2.2. 1  init_safobJ_table  CSC 

This  CSU  initializes  a  SAP  object  table  by  setting  all  elements  to  zero. 


2.2. 2.2  allocate_safobJ  CSU 

This  CSU  allocates  a  SAP  object  table,  if  a  check  of  the  id  passed  does  not  already  show  it 
in  use.  It  does  so  by  allocating  memory  for  it,  zeroing  out  the  memory,  and  assigning  the 
SAP  type  passed  to  the  saf_type  for  that  id  in  the  SAP  object  table  (g_safobj_table[idj- 
>saf_type). 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

id 

unsioned  int 

Standard 

saf  type 

unsigned  short 

Standard 

1  ReturnValues  1 

[Return  Value 

Meaning 

pointer  to  SAF  OBJECT 

Pointer  to  the  table 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  OUT 

The  allocated  SAF  object  is  already  in  use 

1  Calls  1 

Function 

Where  Described 

heap  allocate 

Sec  2.14  2  11 

ERROR  OUT 

Sec  2.5. 2.2 

Table  2.2-23:  allocate  safobj  (’SU  [8.2.2.21 
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2. 2. 2. 3  deallocate_safobj  CSLI 

This  CSU  releases  the  SAP  object  memory  and  sets  its  table  identification  to  NULL. 


1  Parameters  ! 

Parameters 

Where  Typedef  Declared 

id 

unsianed  int 

Standard 

1  Calls 

Function 

Where  Described 

heap  .deallocate 

Sec.  2.14.2.1.4 

Table  2.2-24:  deallocate_safobj  CSU  [8.2.2.31 


2.2.3  tickable.c  CSC 

/simnet/src/host/tickable.c 

The  tickable.c  CSC  structure  is  shown  in  Pigure  2.2-8.  This  CSC  contains  the  CSUs  to 
create  and  delete  the  TICKABLE_VARS  structure  with  all  of  the  vehicle  ticking  variables. 
It  also  contains  the  CSUs  to  cause  a  vehicle  to  start  and  stop  ticking.  The  way  a  vehicle  is 
simulated  is  by  updating  its  state  at  periodic  intervals,  called  ticks.  At  this  time,  the 
program  checks  to  insure  that  a  state  change  is  not  needed  in  any  facet  of  the  simulation.  If 
a  state  change  is  needed,  the  program  accomplishes  this  task.  Appearance  packets  are  sent 
at  this  time  as  needed.  A  vehicle's  tick  rate  (how  often  its  condition  is  updated  and 
displayed)  can  be  adjusted  for  various  reasons,  one  of  which  being  destruction.  (Dead 
vehicles  tick  much  less  frequently  that-,  live  ones,  since  they  do  nothing  but  send  out 
appearance  packets.) 


Figure  2.2-8:  tickable.c  CSC  Structure 
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2.2.3. 1  create  tickable  CSU 


This  CSU  causes  a  memoiy  heap  to  build  a  periodic  interval  (tickable)  and  initializes  it 
(based  on  the  parameters  passed),  returning  a  pointer  to  the  TICKABLE_VARS  structure. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

tick  function 

FUNC  PTR 

period 

unsigned  int 

Standard 

1  ReturnValues  1 

Return  Value 

Meanina 

tickable 

pointer  to  TICKABLE  VARS 

Points  to  memory  structure 

1  Calls  1 

Function 

Where  Described 

allocate  tickable 

Sec.  2.9. 1.2  See  Appendix  A 

qet  millisecond  time 

Sec.  2.14.3.3.2 

Table  2.2-25;  create  tickable  CSU  [8.2.3.i] 


2. 2. 3. 2  destroy_tickable  CSU 


This  CSU  destroys  a  tickable  by  releasing  its  memory  heap. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

tickable 

pointer  to  TICKABLE  VARS 

1  Calls  1 

Function 

Where  Described 

deallocate  tickable 

Sec.  2.9.1. 2  See  Appendix  A 

Table  2.2-26:  destroy  tickable  CSU  [8.2.3.2] 

2. 2. 3. 3  startticking 

CSU 

This- CSU  causes  a  SAF  object  to  start  ticking  through  a  call  to  periodic_fnc  1 

1  Parameters  I 

Parameters 

Where  Typedef  Declared 

safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

periodic  fnci 

Sec  2  2  1.1.2 

Table  2.2-27:  start Jicking  CSC  [8.2.3.31 
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2. 2. 3. 4  stop_ticking  CSU 


This  CSU  causes  a  SAP  object  to  stop  dcking  through  a  call  to  cancel_fncl. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

cancel  fnci 

Sec.  2.2.1. 1.4 

Table  2.2-28:  stop_tlcking  CSU  [8.2.3.4] 


2. 2. 3. 5  change_tick_rate  CSU 


This  CSU  changes  a  SAP  object's  tick  rate  by  first  changing  the  object's  tickable  period  in 
milliseconds  to  the  value  passed  in  the  period  parameter  and  then  c^ling 
change_fncl_period. 


i  Parameters  1 

Parameters 

Where  Typedef  Declared 

safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

period 

unsigned  int 

Standard 

1  Calls  1 

Function 

Where  Described 

change  fncI  period 

Sec.  2.2.1. 1.6 

Table  2.2-29:  change_tick_rate  CSU  [8.2.3.5] 


2. 2. 3. 6  tickable_note_start_tick  CSU 


This  CSU  notes  the  start  of  the  tick  by  obtaining  the  tickable  time  since  the  last  tick  and 
updating  the  current  time  (tickable  >now)  to  the  last  millisecond  time. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

tickable 

pointer  to  TICKABLE  VARS 

Sec.  2.9. 1.2 

Table  2.2-30:  tickable  note  start  tick  CSU  [8.2.3.6] 
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2.2.4  saf.c  CSC 

/simnet/src/host/saf.c 


This  CSC  contains  the  code  to  reset  the  Simhost  CSCI  (phantom  program)  and  to  clear 
the  vehicles  currently  being  simulated.  Figure  2.2-'^  presents  the  saf.c  CSC  structure. 


saf.complete 
CSU8 


lete  reset  A  f  8af_reset_for_work8tation'\  ^ 
.2.4.1  )  CSU  8.2.4  2  J 


8af_remove_vehicle 
CSU  8.2.4.3 


(eliminate  vehicles  ^ 

CSU  872.4.4  J 


Figure  2.2-9:  saf.c  CSC  Structure 


2. 2. 4.1  saf__complete_,reset  CSU 


This  CSU  completely  resets  all  current  SAF  vehicles  by  checking  each  SAF  object  for 
existance,  and  then  eliminating  the  vehicle  if  it  does  exist. 


Its 


1  Calls  1 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9. 1.1  See  Appendix  A 

eliminate  vehicles 

Sec.  2.2  4.4 

Table  2.2-31:  saf_compIete_reset  CSU  [8.2.4.11 


2. 2. 4. 2  saf_reset_for_workstation  CSU 

This  CSU  resets  all  current  SAF  vehicles  used  by  the  requesting  workstation  by  checking 
for  the  existance  of  each  of  the  workstation's  SAF  objects,  and  then  eliminating  the  existing 
vehicles. 


I  Parameters  I 

Parameters 

Where  Tvpedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec  2.43.3 

42 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


1  Calls  1 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9. 1.1  See  Appendix  A 

OBJ  OWNER  PORT 
NUMBER 

Sec.  2.9.1. 1  See  Appendix  A 

eliminate  vehicles 

Sec.  2.2.4.4 

Table  2.2-32: 

saf_reset_for_workstation  CSU  [8.2.4.2] 

2. 2. 4. 3  saf_remove_vehicle  CSU 

This  CSU  removes  a  vehicle,  whose  identification  number  is  passed  as  the  sole  parameter. 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

id 

unsiqned  int 

Standard 

Calls 

Function 

Where  Described 

eliminate  vehicles 

Sec.  2.2.4  4 

Table  2.2-33:  saf_remove_vehic1e  CSU  [8.2.4.3] 


2.2. 4.4  eliminate_vehicles 

This  CSU  eliminates  the  number  of  vehicles  passed  in  the  vehicle  list,  which  is  also 
passed.  It  searches  for  each  vehicle,  and  informs  the  world  that  it  is  disappearing  via  a  call 
to  remove_vehicles.  It  then  searches  for  each  vehicle  again  on  the  vehicle  list,  and  if  the 
vehicle  does  exist,  it  removes  it  through  a  call  to  go_away.  If  the  vehicle  does  not  exist,  it 
sends  an  error  message  to  the  terminal  via  ERROR_OUT. 


Parameters 


Parameters 


num  V 


v  list 


1073 


mt 


unsiqned  int 


Where  Tyoedef  Declared 


Standard 


Standard 


Error  Name 


ERROR  OUT 


Errors 


Reason  for  Error 


Attempted  to  eliminate  a  vehicle  that  doesn't  exist. 


Calls 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9. 1.1  See  Appendix  A 

remove  vehicles 

Sec.  2.14.1.1.5 

Sec.  2.14.1.1.6 


ERROR  OUT  Sec.  2.5.2  2 


Table  2.2-34:  eliminate  vehicles  CSU  [8.2.4.4] 
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2.3  SIMNET  INTERFACE  CSC 

Code  running  on  an  intelligent  Ethernet  controller  receives  SIMNET  protocol  packets  from 
the  network,  filters  them,  and  places  them  on  a  queue.  When  the  SIMNET  interface  code 
on  the  main  processor  gets  ticked  (called  periodically)  by  the  Scheduler  CSC,  it  copies 
these  packets  into  a  second  queue  and  places  the  addresses  of  these  packets  on  the  queues 
of  appropriate  Local  Vehicles,  Remote  Vehicles,  Units,  and  SAF  Command  Interface 
instantiations  so  that  these  packets  can  be  processed  when  the  CSC  is  ticked.  The 
SIMNET  Interface  CSC  gets  called  directly  by  these  CSC  instantiations  when  the  SAF 
Simhost  CSCI  is  to  send  out  SIMNET  packets.  These  calls  take  place  in  the  thread  of  the 
CSC's  ticks,  not  the  SIMNET  Interface  CSCs  tick. 


Figure  2.3-1:  Simnet  Interface  CSC'  Structure 
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2.3.1  pro_sini.c  CSC 
/simnet/src/host/pro_sim.c 

This  CSC  handles  sending  out  fire  and  damage  packets  to  the  other  vehicles  on  the 
network. 


2. 3. 1.1  genera te_a_deactivate  CSU 

This  CSU  calls  simnet_send_deactivate  if  the  vehicle  is  some  form  of  local  simulator  type. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

id 

unsianed  int 

Standard 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLES 

Sec.  2.9.3.2 

simnet  send  deactivate 

ERROR  OUT 

Sec.  2.5.2.2 

Table  2.3-1:  genera te_a_deactivate  CSU  [8.3. 1.1] 


2.3. 1.2  vehicle_kill  CSU 

How  this  CSU  kills  a  vehicle  depends  on  whether  the  vehicle  is  local  or  remote.  If  local,  a 
call  is  made  to  saf_vehicle_catastrophic_kill.  If  the  vehicle  is  remote,  a  call  is  made  to 
vehicle_kilLremote.  If  the  vehicle  is  neither,  an  error  message  is  sent  indicating  that  the 
vehicle  with  that  id  can  not  be  located. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

id 

unsiqned  int 

Standard 

Calls 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9. 1.1  See  Appendix  A 

SAF  LOCAL  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

saf  vehicle  catastrophic  kill 

Sec.  2.6.1.1.25 

SAF  REMOTE  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

vehicle  kill  remote 

Sec.  2.3.1. 3 

ERROR  OUT 

Sec.  2.5.2  2 

Table  2.3-2:  vehicle  kill  CSU  [8.3.1.2] 
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2.3. 1.3  vehicle  kill  remote  CSU 


This  CSU  kills  a  remote  vehicle  by  getting  the  vehicle's  position  and  calling 
simnet_send_impact  to  send  a  lethal  hit 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

id 

unsigned  int 

Standard 

1  Calls  1 

Function 

Where  Described  1 

LOOKUP  POSITION 

. . . 

simnet  send  impact 

1 

Table  2.3-3:  vehicle  kill  remote  CSU  [8.3.1.3] 


2.3. 1.4  generate_indirect_fire_packet  CSU 


This  CSU  checks  the  artillary  type,  and,  if  it  is  an  existing  type  (vehicle  or  ground)  and  the 
vehicle  target  exists,  determines  hit  position  and  calls  simnet_send_indirect_fire. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

mp 

pointer  to  ARTY  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

ERROR  OUT 

Sec.  2.5.2  2 

vec  copy 

Sec.  2.6.2.59.1  in  Vehicles  CSCI  SDD 

tdb  get  gl 

Sec.  2.14.1.2.2 

simnet  send  indirect  fire 

Table  2.3-4;  generate_mdirect_fire_packet  CSU  [8.3. 1.4] 


2. 3. 1.5  vehicle_bong  CSU 


This  CSU  applies  a  deadly  vehicle  impact  by  searching  for  the  remote  vehicle  and,  if 
found,  calling  vehicle_kill_remote. 


i  Parameters  1 

Parameters 

Type 

Where  Tvoedef  Declared 

victim  id 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

vehicle  kill  remote 

Sec.  2.3.1. 3 

Table  2. -^-5:  vehicle_bong  CSl!  [8. 3.1. 5! 
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2.3. 1.6  vehicle_ping  CSU 


This  CSU  applies  a  mild  vehicle  impact  from  the  parser  by  searching  for  the  remote  vehicle 
and,  if  it  is  found,  acquiring  the  vehicle  position  and  calling  simnet_send_impact. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

victim  id 

unsianed  int 

Standard 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

LOOKUP  POSITION 

Sec.  2.9.1. 1 

simnet  send  impact 

Table  2.3-6:  vehicle_ping  CSU  [8.3.1.6] 


2.3.2  simnet.c  CSC 

/simnet/src/host/simnet.c 

This  CSC  handles  receiving,  queuing  and  distributing  relevant  SIMNET  simulation  packets 
received  from  the  network.  In  addition  to  the  CSUs,  there  is  a  single  constant  define  called 
NUM_SIMNET_BUFS  setting  the  number  of  SIMNET  buffers,  and  two  string 
definitions,  as  shown  in  the  following  two  tables. 


Constant 

Value 

NUM  SIMNET  BUFS 

4096 

Table  2.3-“’:  NUM_SIMNET_BUFS  Constant  Definition 


Pointer  Name 

char  *enp  device  = 

7dev/enp0"  I 

char*q  netstart  arqsfl  = 

Table  2.3-8:  simnet.c  String  Definitions 
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2.3.2. 1  start  simnet  CSIJ 


This  CSU  performs  all  the  tasks  required  to  stan  the  SIMNET  Interface. 


1  Calls  1 

Function 

Where  Described 

buffer  pool  allocate 

Sec.  2.14.4.1.13 

PointToPointOpen 

Sec.  2.1.1 .2.2.1. 1  in  Vehicles  CSCI  SDD 

ERROR  OUT 

Sec.  2.5  2.2  * 

AssocError 

Sec.  2.20.1.10.11  in  MCC  CSCI  SDD 

exit  all  sbx  conns 

Sec.  2.4.3.2  2 

simnet  exit 

Sec.  2.3.2.7 

fork 

execve 

AssocSubscrif 

Sec.  2.20.1.10.11  in  MCC  CSCI  SDD 

periodic  fnci 

Sec.  2.2. 1.1. 2 

simnet  zerostats 

Sec.  2.3.2.9 

Table  2.3-9;  start  simnet  CSU  [8.3.2.1] 


2. 3. 2. 2  simnet  tick  CSU 


This  CSU  performs  all  the  tasks  required  for  each  SIMNET  tick. 


1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  OUT 

Error  from  association  layer  on  tick 

ERROR  OUT 

Received  packet  of  unknown  protocol 

Calls 

Function 

Where  Described 

AssocTickAssocLaver 

Sec.  2.20.1.8.1  in  MCC  CSCI  SDD 

ERROR  OUT 

Sec.  2.3.2  2 

AssocError 

Sec.  2.20.1.10.11  in  MCC  CSCI  SDD 

PointToPointReceivePDU 

Sec.  2.1.1.2.2.2.1  in  Vehicles  CSCI  SDD 

AssocSendResponse 

Sec.  2.20.1.4.2  in  MCC  CSCI  SDD 

interestino  packet  test 

Sec.  2.3  2.11 

buffer  allocate  from  pool 

Sec.  2.14.4.1.10 

protocol  Sim  process 

Sec.  2.3.2.12 

buffer  deallocate 

Sec.  2.14.4.2.14 

buffer  allocate 

Sec.  2.14.4.2.12 

protocol  stealth  process 

Sec.  2.3.2.13 

qet  sender  of  last  packet 

Sec.  2.3.2.15 

Table  2.3-10:  simnet  tick  CSU  [8.3. 2. 2] 
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2. 3. 2. 3  AssocGetSimAddress  CSU 

This  CSU  sets  the  site  and  host  elements  of  the  passed  simulation  address  structure  to 
g_site_number  and  g_host_number,  respectively. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

handle 

int 

Standard 

simAddress 

pointer  to  SimuiationAddress 

address.h 

Table  2.3-11:  AssocGetSimAddress  CSU  [8.3.2.3] 


2. 3. 2. 4  ApplicationGetSiteHost  CSU 

This  CSU  sets  the  site  pointer  to  g_site_number  and  the  host  pointer  to  g_host_number. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

handle 

int 

Standard 

site 

pointer  to  short 

Standard 

host 

pointer  to  short 

Standard 

Table  2.3-12:  ApplicationGetSiteHost  CSU  [8.3.2.4] 


Prior  to  CSU  SAF_NET_SND_KLUIXjE,  g_ethemet_two_packets,  which  determines 
which  packet  type  is  sent,  is  set  to  FALSE  and  the  following  header  values  are  defined. 


static  NetworkHeader  hdr 


{ {  Oxff,  Oxff,  Oxff,  Oxff,  Oxff  }, 
{  Oxff,  Oxff,  Oxff,  Oxff,  Oxff  ) , 
21000  }, 


2. 3. 2. 5  SAF_NET_SND_KLUDGE  CSU 

This  CSU  allows  the  sending  of  Ethernet  2.0  packets. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

h 

int 

Standard 

to 

pointer  to  NetworkAddress 

network. h 

but 

pointer  to  char 

Standard 

len 

int 

Standard 

flaqs 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Meaning 

net  send{h,  to, but,  len,  flaqs) 

int 

Not  2.0  packets 

net_send(h,  &hdr,  but,  len, 
flaqs) 

int 

2.0  packets,  bcopy  required 
before  this  return 
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1  Calls  1 

Function 

Where  Described 

net  send 

Sec.  2.20.2.15.1  in  MCC  CSCI  SDD 

Table  2.3-13:  SAF_NET_SND_KLUDGE  CSU  [8.3.2.51 


2. 3. 2. 6  host_loopback_function  CSU 

This  CSU  determines  if  a  looped  back  packet  is  of  interest.  If  the  protocol  number 
indicates  a  simulation,  protocol_sim_process  is  called.  If  the  protocol  number  indicates  a 
collection  of  data,  protocol_data_process  is  called.  If  the  protocol  is  neither, 
ERROR_OUT  is  called  informing  the  user  that  the  packet  protocol  is  unknown. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

data 

pointer  to  char 

Standard 

length 

long  int 

Standard 

arouD 

MulticastGroupID 

p  assoc. h 

protocol 

AssociationUserProtocol 

p  assoc,  h 

Errors 

Error  Name 

Reason  for  Error 

ERROR  OUT 

Unknown  packet  type 

Calls 

Function 

Where  Described 

interestinq  packet  test 

Sec.  2.3.2.11 

protocol  sini  process 

Sec.  2.3.2.12 

protocol  data  process 

Sec.  2.3.2.14 

ERROR  OUT 

Sec.  2.5.2.2 

Table  2.3-14:  host  loopback  function  CSU  [8.3.2.6j 


2. 3. 2. 7  simnet  exit  CSU 

This  CSU  calls  AssocClose,  passing  the  SIMNEl  handle  as  a  parameter. 


1  Calls  1 

Function 

Where  Described 

AssocClose 

Sec.  2  20  1.11.1  in  MCC  CSCI  SDD 

Table  2.3-15:  simnet  exit  CSU  [8.3.2.7] 


5-: 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2. 3. 2. 8  simnet_getstats  CSU 

This  CSU  gets  the  SIMNET  statistics  and  prints  them. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

stats!  1001 

long 

Standard 

SI411 

char 

Standard 

register  int 

Standard 

Calls 

Function 

Where  Described 

net  aet  statistics 

Sec.  2.20.2.5.1  in  MCC  CSCI  SDD 

net.  stat  string 

Sec.  2.20.2.5.3  in  MCC  CSCI  SDD 

Table  2.3-16:  simnet_getstats  CSU  [8.3.2.8] 


2. 3. 2. 9  simnet_zerostats  CSU 

This  CSU  initializes  or  sets  to  zero  the  SIMNET  statistics. 


1  Calls  1 

Function 

Where  Described 

net  zero  statistics 

Sec.  2.20.2.5.2  in  MCC  CSCI  SDD 

Table  2.3-17:  simnet  zerostats  CSU  [8.2.1.2.9] 


2.3.2.10  enqueue_on_rcvq  CSU 

This  CSU  places  a  simple  received  SAP  object  packet  on  the  receive  queue  if  the  queue  is 
not  out  of  space. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

id 

unsigned  int 

Standard 

pdu 

pointer  to  char 

Standard 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

OBJ  SIMPLE  RCVQ 

Sec.  2.9.3.2  See  Appendix  A 

buffer  simple  enqueue 

Sec.  2.14.4.1.14 

Table  2.3-18:  enqueue_on_rcvq  CSU  [8.3.2.10] 
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2.3.2.11  interesting_packet_test  CSU 

This  CSU  determines  if  message  protocol  and  kind  warrant  immediate  interest. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

protocol 

AssociationUserProtocol 

p  assoc,  h 

pdu 

pointer  to  char 

Standard 

cached  saf  id 

pointer  to  unsianed  int 

Standard 

1  ReturnVatues  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

Interestina 

FALSE 

int 

Not  interestina 

1  Calls  1 

Function 

Where  Described 

saf  id  from  simnet  id 

IS  MISSILE 

LOOKUP  VEHICLE 

k{:!Jt4:lkMkrTl1  H  M  II  i 

Table  2.3-19:  interesting_packet_test  CSU  [8.3.2.11] 


2.3.2.12  protocol_sim_process  CSU 

This  CSU  processes  a  simulation  process  if  it  is  the  correct  protocol  version  and  is  not  a 
packet  with  an  exercise  identification  number  attached.  The  processing  depends  on  the 
kind  of  simulation  PDU  received  and  uses  a  switch  on  case. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

spdu 

pointer  to  SimulationPDU 

p  sim.h 

cached  saf  id 

unsiqned  int 

Standard 

Calls 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5  2.2 

LOOKUP  VEHICLE 

Sec.  2.9. 3.2  See  Appendix  A 

enqueue  on  rcvq 

Sec.  2.3.2.10 

qet  sender  of  last  packet 

Sec.  2.3.2.15 

simnet  id  strinq  from  saf  id 

create  remote  vehicle 

Sec.  2.7.1.17 

remote  new  appearance 

Sec.  2.7.1.12 

qround  input  to  sbx 

Sec.  2.4.3.2.24 

vehicle  impact  to  sbx 

Sec.  2.4.3.2.25 

indirect  fire  to  sbx 

Sec.  2.4.3.2.23 

buffer  simple  enqueue 

Sec.  2.14.4.1.14 

OBJ  SIMPLE  RCVO 

Sec.  2.9. 1.1  See  Appendix  A 

Table  2.3-20:  prolocol_sim_process  CSU  f8..3.2.l2] 
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2.3.2.13  protocoI_stealth_process  CSU 


This  CSU  first  determines  if  the  stealth  protocol  is  of  the  current  version,  ignoring  it  if  it  is 
not.  It  then  determines  the  kind  of  stealth  PDU  and,  unless  it  is  a  stealth  appearance  type  of 
PDU,  ignores  the  PDU.  Otherwise,  it  processes  the  message  as  required. 


Parameters 


Parameters 


stlthodu 


cached  saf  id 


irs 


inter  to  SteaithPOU 


unsianed  int 


IR 


Where  Tvoedef  Declared 


stith.h 


Standard 


Calls 


Function  Where  Described 


ERROR  OUT  Sec.  2  5.2.2 


et  sender  of  last  oacket  Sec.  2.3.2.15 


LOOKUP  VEHICLE  Sec.  2.9.3.2 


simnet  id  strino  from  saf  id 


create  remote  vehicle  Sec.  2.7.1.17 


remote  new  appearance  Sec.  2.7.1.12 


Table  2.3-21:  protocol_stealth_process  CSU  [8.3.2.13] 

2.3.2.14  protocol_data_process  CSU 

This  CSU  prints  out  a  message  questioning  why  the  software  has  called  this  routine.  It 
should  not  have  received  and  be  viewing  a  data  packet. 


Parameters 


dcpdu 


cached  saf  id 


Parameters 


e  Where  Typedef  Declared 


inter  to  DataCoilectionDPU  p  data.h 


unsianed  int  Standard 


IBT? 

irs 


Calls 

Function 

Where  Described 

ERROR  OUT 

Section  2.5.2.2 

Table  2.3-22:  protocol_data_process  CSU  [8.3.2.14] 

2.3.2.15  get_sender_oMast_packet  CSU 

This  CSU  returns  a  pointer  to  the  network  address  (first  six  elements  of  buffer  array)  of  the 
last  message  sender. 


Return  Value 


*buf 


Function 


AssocGetLastAddress 


11^ 


ReturnValues 


inter  to  char 


Meanin 


Last  sender  address 


Calls 


Where  Described 


Sec.  2.20.1.15.1  MCCCSCISDD 


Table  2.3-23:  get_sender_of_last_packet  CSU  [8.3.2.15] 
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2.4  SAP  COMMAND  INTERFACE  CSC 


The  SAP  Command  Interface  CSC  runs  when  ticked  by  the  scheduler.  Its  code  accepts 
and  processes  commands  from  the  SAP  Workstation  CSCI  and  returns  reports  to  it. 


Figure  2.4-1:  SAF  Command  Interface  CSC  Structure 

Command  messages  come  to  the  SAP  Simhost  HWC.l  via  an  Ethernet  LAN  connection. 
The  SAP  Simhost  CSCI  receives  the  commands  from  a  UNIX  socket.  The  command 
packets  are  IP/UDP  packets.  An  additional  network  layer  called  RUDP  is  placed  over  the 
UDP  layer.  This  RUDP  layer  is  implemented  in  the  SAP  command  interface  code  to 
provide  reliable  transmission  of  the  command  packets.  After  going  through  the  RUOP 
layer,  the  packets  are  converted  to  SAP  Command  Protocol  })ackeis.  W  hen  these  packets 
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are  processed  and  interpreted,  the  state  of  the  simulation  objects  is  changed  appropriately  so 
that  when  these  objects  next  get  ticked  they  will  respond  to  the  orders  they  have  received 
from  the  workstation. 


2.4.1  SAF  Command  Protocol  CSC 

The  SAF  Command  Protocol  CSC  [8.4.1]  is  contained  in  the  file  messages.h. 


2.4. 1.1  messages.h  CSU 

/simnel/include/saf/src/messages.h 

This  file  contains  the  message  constants  and  formats  (structures)  for  communication  with 
the  workstation.  Each  different  type  of  information  has  it's  own  message  type  and  constant 
associated  with  it. 

The  following  constant  definitions  are  the  messages  from  Symbolics  to  MIPS  machines. 
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Constant 

Value 

OPFOR  MSG  CREATE 

1 

OPFOR  MSG  RESET 

2 

OPFOR  MSG  ARTY 

3 

OPFOR  MSG  READ  CONFIG 

4 

OPFOR  MSG  VEHICLE  REINIT 

5 

OPFOR  MSG  RESUME 

6 

OPFOR  MSG  RESUPPLY 

8 

OPFOR  MSG  ATTACH 

9 

OPFOR  MSG  DETACH 

10 

OPFOR  MSG  TELEPORT 

11 

OPFOR  MSG  POLL 

14 

OPFOR  MSG  MINEFIELD 

16 

OPFOR  MSG  DISCONNECT 

17 

OPFOR  MSG  QUERY  SUB  STATE 

18 

OPFOR  MSG  IVIS  XMIT  MODES 

19 

OPFOR  MSG  IVIS  PARAMETERS 

20 

OPFOR  MSG  CONTINUE  MISSION 

21 

OPFOR  MSG  ASSIGN  ROUTE 

22 

OPFOR  MSG  POINT 

23 

OPFOR  MSG  AREA 

24 

OPFOR  MSG  ZONE 

25 

OPFOR  MSG  LINE 

26 

OPFOR  MSG  ROUTE 

27 

OPFOR  MSG  DELETE  OVERLAY 

28 

OPFOR  MSG  EXECUTE  OVERLAY 

29 

OPFOR  MSG  HALT 

30 

OPFOR  MSG  CHANGE  SPEED 

31 

OPFOR  MSG  CHANGE  FORMATION 

32 

OPFOR  MSG  DELETE  CM 

33 

OPFOR  MSG  FOLLOW  VEHICLE 

34 

OPFOR  MSG  GOTO  POINT 

35 

OPFOR  MSG  RESUME  MISSION 

36 

OPFOR  MSG  FACE  DIRECTION 

37 

OPFOR  MSG  SET  TARGETING 

38 

OPFOR  MSG  ATTACH  STEALTH 

39 

OPFOR  MSG  HOLD 

40 

OPFOR  MSG  ALTITUDE 

41 

OPFOR  MSG  ENROUTE  MOVEMENT 

42 

OPFOR  MSG  SIMULATOR  IN  COMMAND 

43 

OPFOR  MSG  REJOIN  UNIT 

44 

OPFOR  MSG  LAND 

45 

OPFOR  MSG  ATTACK 

46 

OPFOR  MSG  CHECK  STATION 

47 

Table  2.4-1:  Symbolics  to  MIPS  Messages  Constant  Definitions 
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In  the  following  header  structure,  OPFOR_HEADER,  "id"  is  the  unit  id  and  "type"  is  the 
message  type. 


item 

Type 

Where  Type  Defined 

id 

unsianed  short 

Standard 

tvoe 

unsianed  short 

Standard 

Table  2.4-2:  OPFOR_HEADER  Structure  Definition 

The  generic  message,  OPFOR_GENERIC_MSG,  consists  of  the  previously  defined 
header  structure  and  the  first  byte  of  data.  This  structure  is  used  to  refer  to  messages  whose 
type  has  not  been  deEned. 


item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Previous  structure 

data 

char 

Standard 

Table  2.4-3:  OPFOR_GENERIC_MSG  Structure  Definition 

The  create  message,  using  structure  CREATE_MSG,  causes  a  unit  and  all  its  inferior  units 
to  be  instantiated  by  the  Simhost. 


item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stmcture  in  this  file 

forcelD 

unsigned  char 

Standard 

countryD 

unsigned  char 

Standard 

countryO 

unsigned  char 

Standard 

tactics 

unsigned  char 

Standard 

echelon 

unsigned  char 

Standard 

echelon  type 

unsigned  char 

Standard 

sbx  unique  id 

unsigned  char 

Standard 

padi 

unsigned  char 

Standard 

formation[361 

char 

Standard 

heading 

REAL 

Sim  types. h 

positionfSI 

REAL 

Sim  types. h 

battalion 

unsigned  short 

Standard 

company 

unsigned  char 

Standard 

platoon 

unsigned  char 

Standard 

percent  ammo 

float 

Standard 

percent  fuel 

float 

Standard 

Table  2.4-4:  CREATE_MSG  Structure  Definition 

The  reset  message,  whose  structure  is  RESET_MSG,  is  the  only  message  that  travels  in 
both  directions  between  Symbolics  and  Simhost.  A  reset  message  from  the  Symbolics 
instructs  the  Simhost  to  delete  the  indicated  vehicles  and  return  the  message  as 
confirmation.  A  reset  from  the  Simhost  instructs  the  Symbolics  that  the  indicated  vehicles 
are  no  longer  in  the  simulated  world. 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

int 

Standard 

unit  count 

int 

Standard 

unit_listl321 

unsigned  int 

Standard 

Table  2.4-5:  RESET_MSG  Structure  Deflnition 

If  the  flags  field  has  the  value  RESET_ALL_VEHICLES,  aU  vehicles  created  by  that 
workstation  are  reset. 


Constant 

Value 

RESET  ALL  VEHICLES 

0x0001 

Table  2.4-6:  RESET_ALL_VEHICLES  Constant  Definition 

The  artillery  message,  whose  structure  is  ARTY_MSG,  instructs  the  Simhost  to  generate 
MCC-like  artillery  at  the  indicated  position. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stmcture  in  this  file 

int 

Standard 

ammo 

int 

Standard 

fuze 

int 

Standard 

count 

int 

Standard 

spread 

float 

Standard 

positionf31 

REAL 

Table  2.4-7:  ARTY  MSG  Structure  Definition 


Constant 

Value 

MAX  WEAPONS  ON  NET 

4 

Table  2.4-8:  MAX_WEAPONS_ON_NET  Constant  Definition 

The  vehicle  reinitialize  message,  whose  structure  is  VEHICLE_REINrT_MSG,  sets  the 
state  of  a  vehicle. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

loadsFMAX  WEAPONS  ON  NETl 

Short 

Standard 

fuel 

int 

Standard 

status 

char 

Standard 

1 1 1 1 II 1 II  !■■■— 

char 

Standard 

X 

float 

Standard 

y 

float 

Standard 

bearing 

float 

Standard 

Table  2.4-9:  VEHICLE  REINIT  MSG  Structure  Definitio,. 
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TO 


91703274930? 


F.03 
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The  resupply  message,  whose  structure  is  RESUPPLY_MSG,  causes  a  vehicle  to  be 
refueled  and  reloaded  from  a  resupply  vehicle. 


hfm  I  Type  I  Where  Type  Defined  1 


hdf  OPFOR  HEADER 

Rrst  structure  in  this  tile 

resuDOlv  vehicle  int 

Standard 

Tabic  2.4-10:  RESUPPLY_MSG  Structure  Dermition 


The  attach  message,  whose  structure  is  ATTACH_MSG.  directs  an  unattached  unit  to 
attach  itself  to  a  maneuver  unit  as  an  infoior  vehicle.  This  message  is  unused. 


Item 

Tvne 

Where  Tvoe  Defined 

hdr 

OPFOR  HEADER 

Riat  stnicture  in  this  file 

unit  id 

int 

Standard 

Table  2.4-11:  ATTACH_MSG  Structure  Definition 

The  detach  mesuge.  whose  structure  is  DETACH_MSG,  directs  a  superior  unit  to  detach  a 
subordinate.  This  message  is  unused. 


Item 

Type 

hdr 

OPFOR  HSA6Ert 

Rrst  stmeture  in  this  tile 

unit  id 

int 

Standard  1 

Table  2.4-12:  DETACH.MSG  Structure  DefiniUon 

The  teleport  message,  whose  structure  is  TELEPORT_MSG,  is  die  instantaneous 
movement  of  a  vehicle  so  that  it  appears  immediately  at  die  desired  location. 


Item 

Tvoe 

Where  Tvne  Defined 

hdr 

OPF6t^  HfeAbER 

Rrst  structure  in  this  file 

headino 

REAL 

Sim  tvoes.h 

Dositionis} 

REAL 

sim  tyoes.h 

Table  2.4-13:  TELEPORT_MSG  Structure  Definition 


Constant 

value 

GODS  EYE  VIEW 

0 

NON  QOD^  EYE  VIEW 

1 

COMMANDERS  EYE  VIEW 

2 

Table  2.4-14:  _VIEW  Constant  Definitions 

The  poll  message,  whose  structure  is  POLL_MSG,  requests  vducle  data  from  the  Simhost 
The  request  field  selects  the  view  vdiich  detetmines  what  vehicle  sends  data  to  the 
Symbolics. 
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Item 

Type 

Where  Tvue  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  fiie 

reauest 

int 

Standard 

Table  2.4'15:  POLL_MSG  Structure  Definition 

The  disconnect  message,  whose  structure  is  DISCX)NNECT_MSG,  tells  die  MIPS 
machine  not  to  communicate  anymore. 


Itam 

Tjfpe 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Rrst  structure  in  this  file 

Table  2.4.16:  DISCONNECT.MSG  Structure  Dennition 


The  queiy  substate  message,  whose  structure  is  QUERY_SUBSTATE_MSG,  requests 
more  informadon  about  a  vehicle  or  composite. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOft  HEADER 

First  structure  in  this  file 

Table  2.4.17:  QUERY.SUBSTATE.MSG  Structure  Definition 

The  IVIS  transmit  modes  message,  whose  structure  is  rVIS_XMrr_MODES_MSG, 
indicates  whether  IVIS  packets  are  transmitted  to  SIMNET  and  whether  IVIS  reports  are 
sent  to  the  Symbolics. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HgAftgR 

Rrst  structure  in  this  file 

xmit  simnet  d 

int 

Standard 

xmit  sbx  D 

int 

Standard 

Table  2.4.18:  IVlS_XMIT_MODES_MSG  Structure  Definition 


Constant 

Value 

^NDALL 

-1 

Si^NDNONE 

0 

SENDCONTACT 

1 

SfeNDSPOt 

2 

SENDSHELL 

1 

Table  2.4*19:  Ivis  Transmit  Modes  Constant  Definitions 
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The  rVIS  parameters  message,  whose  structure  is  IVIS_PARAMETERS_MSG,  allows  an 
operator  at  the  woiicstation  to  change  key  parameters  for  certain  IVIS  reports. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

cluster  distance 

unsianed  int 

Standard 

decluster  distance 

unsianed  int 

Standard 

spot  rep  ranae  threshold 

unsianed  int 

Standard 

report  monitor  time  mse*; 

unsianed  int 

Standard 

max  reappear  latency  msec 

unsianed  int 

Standard 

Table  2.4-20:  IVIS_PARAMETERS_MSG  Structure  Dennition 


The  following  typedef  struct  is  tagged  float_xy_point. 


Item 

Type 

Where  Type  Defined 

X 

float 

Standard 

V 

float 

Standard 

Table  2.4-21:  FLOAT_XY_POINT  Structure  Definition 


While  X  and  y  point  coordinates  are  received  as  float  type,  they  are  stored  internally  as 
REALS.  The  following  typedef  struct  is  tagged  xy_point. 


Item 

Where  Type  Defined 

X 

REAL 

Sim  tvpes.h 

V 

REAL 

sim  types. h 

Table  2.4-22:  XY  POINT  Structure  Definition 


The  following  typedef  struct  is  tagged  sbx_route_pt.  A  route  point  is  tj^ed  by  a  control 
measure  id.  If  the  id  is  even,  x  and  y  are  coordinate  points  on  the  terrain.  If  id  is  odd,  x  is 
a  road  segment  id  and  y  is  a  direction. 


Item 

Type 

Where  Type  Defined 

id 

int 

Standard 

X 

int 

Standard 

y 

int 

Standard 

Table  2.4-23:  SBX_ROUTE_PT  Structure  Definition 
The  following  ASSIGN_ROUTE_MSG  structure  is  unused. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

count 

int 

Standard 

|"|  I'l  1  Hill  II 1 1— ■■ 

FLOAT  XY  POINT 

Earlier  structure  in  this  file 

Table  2.4-24:  ASSIGN_ROUTE_MSG  Structure  DeHnition 
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Constant 

Value 

CM  NAME  SIZE 

20 

CM  TYPE  SIZE 

20 

CIS  NAME  SIZE 

40 

Table  2.4-25:  Control  Measure  Constant  Deflnitions 

The  following  typedef  struct  is  tagged  cm_id.  It  identifies  a  control  measure  by  a  unique 
integer  assigned  by  the  workstation. 


litem 

Type 

Where  Type  Defined 

char 

Standard 

Lid _ 

int 

Standard 

Table  2.4-26:  CM_ID  Structure  Definition 

The  following  typedef  struct  is  tagged  float_cm_point_list.  Like  points,  point  lists  are 
received  as  float  type,  but  are  internally  stored  as  REAL. 


Item 

Where  Type  Defined 

count 

int 

Standard 

FLOAT  XY  POINT 

Earlier  structure  in  this  file 

Table  2.4-27:  FLOAT_CM_,POINT_LIST  Structure  Definition 
The  following  typedef  struct  is  tagged  cm_point_lisL 


Item 

Where  Type  Defined 

count 

int 

Standard 

XY  POINT 

Earlier  stmcture  in  this  File 

Table  2.4-28:  CM  POINT  LIST  Struct .  n'  Definition 


Constant 

Value 

NUM  APPLICABLE  UNITS 

32 

Table  2.4-29:  NUM_APPLICABLE_UNITS  Constant  Definition 
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The  following  typedef  struct  is  tagged  point_msg.  It  creates  a  new  point  control  measure 
as  identified  by  its  point  id. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Rrst  structure  in  this  file 

overiav 

CM  ID 

Earlier  structure  in  this  file 

point 

CM  ID 

Earlier  structure  in  this  file 

X 

float 

Standard 

V 

float 

Standard 

route 

CM  ID 

Earlier  structure  in  this  file 

speed 

float 

Standard 

dslCIS  NAME  SIZE1 

char 

Standard 

report 

short 

Standard 

num  units 

short 

Standard 

applies  tolNUM  APPLICABLE  UNITS1 

short 

Standard 

Table  2.4-30:  POINT_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  area_msg.  It  creates  a  new  area  control  measure  as 
identified  by  its  area  id. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  staicture  in  this  file 

overiav 

CM  ID 

Earlier  structure  in  this  file 

area 

CM  ID 

Earlier  structure  in  this  file 

points 

FLOAT  CM  POINT  LIST 

Earlier  structure  in  this  file 

char 

Standard 

speed 

float 

Standard 

CisrCIS  NAME  SIZE! 

char 

Standard 

report 

short 

Standard 

num  units 

short 

Standard 

applies  tolNUM  APPLICABLE  UNITSl 

short 

Standard 

Table  2.4-31:  AREA_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  zone_msg.  It  creates  a  new  zone  control  measure  as 
identified  by  its  zone  id. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

overiav 

CM  ID 

Earlier  structure  in  this  file 

zone 

CM  ID 

Earlier  structure  in  this  file 

points 

FLOAT  CM  POINT  LIST 

Earlier  structure  in  this  file 

tvpefCM  TYPE  SIZEl 

char 

Standard 

speed 

float 

Standard 

char 

Standard 

report 

short 

Standard 

num  units 

short 

Standard 

applies  tolNUM  APPLICABLE  UNITSl 

short 

Standard 

Table  2.4-32:  ZONE_MSG  Structure  Definition 
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The  following  typedef  struct  is  tagged  line_msg.  It  creates  a  new  line  control  measure  as 
identiHed  by  its  line  id. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

overlay 

CM  ID 

Earlier  structure  in  this  file 

line 

CM  ID 

Earlier  structure  in  this  file 

points 

FLOAT  CM  POINT  LIST 

Earlier  structure  in  this  file 

tvperCM  TYPE  SIZEl 

Char 

Standard 

speed 

float 

Standard 

CislCIS  NAME  SIZEl 

char 

Standard 

report 

short 

Standard 

num  units 

short 

Standard 

applies  tOlNUM  APPLICABLE  UNITS1 

short 

Standard 

Table  2.4*33:  LINE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  route_msg.  It  creates  a  new  route  control  measure 
as  identified  by  its  route  id. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stnjcture  in  this  file 

overlay 

CM  ID 

Earlier  stmcture  in  this  file 

route 

CM  ID 

Earlier  structure  in  this  file 

count 

int 

Standard 

il  lliil  HI  1  i^— 

SBX  ROUTE  POINT 

Earlier  stmcture  in  this  file 

num  units 

Short 

Standard 

applies  tOlNUM  APPLICABLE  UNITSl 

short 

Standard 

Table  2.4-34:  ROUTE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  delete_overlay_msg.  This  message  causes  all 
control  measures  within  an  overlay  to  be  removed. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

overlay 

CM  ID 

Earlier  structure  in  this  file 

Table  2.4-35;  DELETE_OVERLAY_MSG  Structure  Definition 

The  following  typedef  stmct  is  tagged  execute_overlay_msg.  This  message  causes  a  unit 
to  follow  the  indicated  route  and  to  react  to  the  control  measures  that  exist  in  the  overlay. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

overlay 

CM  ID 

Earlier  structure  in  this  file 

route 

CM  ID 

Earlier  structure  in  this  file 

Char 

Standard 

Table  2.4-36:  EXECUTE_OVERLAY_MSG  Structure  Definition 
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The  following  typedef  struct  is  tagged  delete_cm_msg.  This  message  removes  a  control 
measure  from  the  overlay. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

overlay 

CM  ID 

Earlier  structure  in  this  file 

counter  measure 

CM  ID 

Earlier  structure  in  this  file 

Table  2.4*37:  DELETE_CM_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  rejoin_unit.  This  message  causes  a  unit  to  abandon 
its  current  mission,  as  assigned  by  an  execute  overlay  message,  and  to  rejoin  the  mission  of 
its  superior  unit,  if  a  superior  unit  exists. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

Table  2.4-38:  REJOIN_UNIT_MSG  Structure  Definition 

The  following  messages  cause  immediate  intervention  that  supercedes  missions  assigned  in 
overlays.  The  following  typedef  struct  is  tagged  halt_msg.  It  causes  a  unit  to  stop 
movement 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

Table  2.4-39:  HALT^MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  resume_msg.  This  message  causes  a  unit  to  resume 
its  pre-plann^  mission  after  the  unit  has  been  inteirupted  by  one  of  the  immediate 
interventions. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

Table  2.4-40:  RESUME_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  change_speed_msg.  It  causes  a  unit  to  change 
speed. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

speed 

int 

Standard 

Table  2.4-41:  CHANGE_SPEED_MSG  Structure  Definition 
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The  following  typedef  struct  is  tagged  change_fomiation_msg.  It  causes  a  unit  to  change 
formation. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

forTnationr201 

Char 

Standard 

Table  2.4-42:  CHANGE_FORMATION_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  follow_vehicle_msg.  It  causes  a  unit  to  start 
following  a  specified  vehicle. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

xoff  /*  In  leader's  coordinate  */ 

float 

Standard 

votf  r  system*/ 

float 

Standard 

leadid 

unsioned  short 

Standard 

paddina 

unsigned  short 

Standard 

Table  2.4-43:  FOLLOW_VEHICLE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  goto_point_msg.  It  causes  a  unit  to  go  to  a  specified 
location. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Rrst  structure  in  this  file 

X 

float 

Standard 

V 

float 

Standard 

backwardp 

int 

Standard 

int 

Standard 

Table  2.4-44:  GOTO  POINT  MSG  Structure  Definition 


The  following  typedef  struct  is  tagged  resume_mission_msg.  This  message  functions  in 
the  same  manner  as  resume_msg. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  tile 

Table  2.4-45:  RESUME_MISSION_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  face_direction_msg  This  causes  a  unit  to  face  in  a 
specified  direction. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stmcture  in  this  file 

mathradians 

float 

Standard 

Table  2.4-46:  FACE_DIRECTION_MSG  Structure  Definition 
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Constant 

Value 

HOVER  HOLD 

0 

ORBIT  HOLD 

1 

RACETRACK  HOLD 

2 

LAND  HOLD 

3 

Table  2.4-47:  HOLD  Constant  Definitions 


The  following  typedef  struct  is  tagged  hold_msg.  This  causes  an  air-unit  to  stop  at  its 
current  location  and  either  hover,  orbit,  racetrack  or  land  at  that  location. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

int 

Standard 

Table  2.4-48:  HOLD  MSG  Structure  Definition 


Constant 

Value 

ABS  ALTITUDE 

0 

REL  ALTITUDE 

1 

Table  2.4-49:  ALTITUDE  Constant  Definitions 


The  following  typedef  struct  is  tagged  altitude_msg.  This  causes  an  air-unit  to  change  its 
altitude. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stmcture  in  this  file 

altitude 

float 

Standard 

int 

Standard 

Table  2.4-50:  ALTITUDE  MSG  Structure  Definition 


Constant 

Value 

TAC  COL 

0 

BOUND 

1 

BOUND  OVER 

2 

Table  2.4-51:  Enroute  Movement  Constant  Definitions 


The  following  typedef  struct  is  tagged  enroute_movement.  This  message  is  unused. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

int 

Standard 

Table  2.4-52:  ENROUTE  MOVEMENT  MSG  Structure  DeHnition 
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The  following  typedef  struct  is  tagged  simulator_in_command.  This  message  causes  the 
lead  vehicle  of  a  unit  to  be  deactivated.  The  unit  is  thereafter  lead  by  the  simulator  indicated 
in  the  message. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

leadid 

unsianed  short 

Standard 

paddina 

unsigned  short 

Standard 

Table  2.4-53:  SIMULATOR_IN_COMMAND_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  land.  This  message  causes  an  air-unit  to  land  at  the 
specified  location. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stmcture  in  this  file 

X 

float 

Standard 

V 

float 

Standard 

Table  2.4-54:  LAND  MSG  Structure  Definition 


Constant 

Value 

ATTACK  RUNNING  FIRE 

1 

ATTACK  HOVER  FIRE 

2 

Table  2.4-55:  attack_type  Constant  Definitions 

The  following  typedef  struct  is  tagged  attack.  This  message  causes  the  air-unit  to  attack 
between  the  start  and  target  locations.  The  type  of  attack  is  specified  as  an  attack_type. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

attack  type 

int 

Standard 

start  X 

float 

Standard 

start  V 

float 

Standard 

target  x 

float 

Standard 

target  y 

float 

Standard 

Table  2.4-56:  ATTACK_MSG  Structure  Definition 
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The  following  typedef  struct  is  tagged  check_station.  This  message  is  unused. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

Table  2.4-57:  CHECK_STATION_MSG  Structure  Deflnition 

The  following  tyj^ef  struct  is  tagged  set_targedng_msg.  This  message  causes  a  vehicle 
or  unit  to  change  its  targeting  parameters. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

firestatus 

int 

Standard 

max  enaaaement  ranae 

int 

Standard 

marksmanship 

float 

Standard 

position  X 

float 

Standard 

float 

Standard 

radius 

float 

Standard 

tarpetsflGI 

unsiqned  short 

Standard 

Table  2.4-58:  SET_TARGETING_MSG  Structure  Derinition 

The  following  typedef  struct  is  tagged  attach_stealth_msg.  This  message  causes  the  stealth 
vehicle  indicated  by  the  site  and  host  to  attach  in  mimic  inode  to  the  indicated  vehicle  in  the 
OPFOR_HEADER. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

site 

short 

Standard 

host 

short 

Standard 

Table  2.4-59:  ATTACH  STEALTH  MSG  Structure  Derinition 
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The  following  table  contains  the  Simhost  to  Symbolics  message  constant  definitions. 


Constant 

Value 

OPFOR  MSG  CREATION 

100 

OPFOR  MSG  WHERE  ARE  THEY 

101 

OPFOR  MSG  GROUND  IMPACT 

102 

OPFOR  MSG  VEHICLE  IMPACT 

103 

OPFOR  MSG  INTERVISIBILITY 

104 

OPFOR  MSG  NOTIFY 

105 

OPFOR  MSG  VEHICLE  STATUS 

106 

OPFOR  MSG  INDIRECT  FIRE 

108 

OPFOR  MSG  ACTIVITY  COMPLETE 

111 

OPFOR  MSG  MACHINE  STATUS 

114 

OPFOR  MSG  MINEFIELD  CREATION 

115 

OPFOR  MSG  SUB  STATE 

116 

OPFOR  MSG  IVIS  CONTACT 

117 

OPFOR  MSG  IVIS  SPOT 

118 

OPFOR  MSG  IVIS  SHELL 

119 

OPFOR  MSG  VEHICLE  PAE 

120 

OPFOR  MSG  VEHICLE  POSITION 

121 

OPFOR  MSG  VEHICLE  POSITON  POLL  COMPLETED 

122 

OPFOR  MSG  VEHICLE  APPEARANCE 

123 

OPFOR  MSG  VEHICLE  ECHELON 

124 

OPFOR  MSG  GENERIC  MESSAGE 

125 

OPFOR  MSG  STEALTH  POSITION 

126 

OPFOR  MSG  VEHICLE  LOAD 

127 

Table  2.4-60:  Simhost  to  Symbolics  Messages  Constant  Definitions 
GROUND_IMPACT_MSG  informs  the  Symbolics  of  a  ground-impact  on  the  battlefield. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

ammunition 

unsiqned  char 

Standard 

quantity 

unsiqned  char 

Standard 

paddinq 

short 

Standard 

locx 

float 

Standard 

locy 

float 

Standard 

Table  2.4-61:  GROUND^IMPACT_MSG  Structure  Definition 
VEHICLE_IMPACT_MSG  informs  the  Symbolics  of  a  vehicle-impact  on  the  battlefield. 


Item 

Type 

Where  Type  Defined 

hdr  r  Contains  attacker  id  */ 

OPFOR  HEADER 

First  structure  in  this  file 

target  id 

int 

Standard 

round  type 

int 

Standard 

burst  length 

int 

Standard 

Table  2.4-62:  VEHICLE  IMPACT  MSG  Structure  Definition 
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MACHINE_STATUS_MSG  is  sent  to  the  Symbolics  when  a  connection  is  established. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

real  time  clock  value 

unsiqned  int 

Standard 

Table  2.4-63:  MACHINE  STATUS  MSG  Structure  Deflnition 


INDIRECT_FIRE_MSG  informs  the  Symbolics  of  indirect  fire  on  the  battlefield.  It 
contains  one  or  more  indirect-fire  bursts. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Rrst  structure  in  this  file 

ammunition 

unsiqned  char 

Standard 

fuze 

unsiqned  char 

Standard 

quantity 

unsiqned  char 

Standard 

rate 

unsiqned  char 

Standard 

Table  2.4-64:  INDIRECT  FIRE  MSG  Structure  Definition 


Item 

Type 

Where  Type  Defined 

locx 

float 

Standard 

locv 

float 

Standard 

locz 

float 

Standard 

delay 

short 

Standard 

paddinq 

short 

Standard 

Table  2.4-65:  INDIRECT_FIRE_BURST  Structure  Dermition 

The  following  typedef  struct  is  tagged  vehicle_postion_descriptor.  It  describes  the 
position,  direction  and  turret  angle  of  a  vehicle. 


Item 

Type 

Where  Type  Defined 

X  r  Simnet  x  position  */ 

float 

Standard 

y  r  Simnet  y  position  V 

float 

Standard 

direction  anqie 

float 

Standard 

turret  anqie 

float 

Standard 

Table  2.4-66: 


VEHICLE_POSITION_DtSCRIPTOR  Structure  Definition 
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The  following  typedef  struct  is  tagged  vehicle_^pearance_descriptor.  It  describes  the 
appearance  of  a  vehicle. 


litem 

Type 

Where  Type  Defined 

iocxi 

r  Apoearance  V 

unsianed  char 

Standard 

status 

/*SAF  status  data*/ 

unsianed  char 

Standard 

force 

r  Simnet  force  data  */ 

unsianed  short 

Standard 

tactics 

/*SAF  tactics  data*/ 

unsianed  char 

Standard 

1  markinal  1 1 1  /*  Markina  field  */ 

char 

Standard 

Table  2.4-67;  VEHICLE_APPEARANCE_DESCRIPTOR  Structure 

Definition 

The  following  typedef  struct  is  tagged  vehicle_echelon_descriptor.  It  describes  the  position 
of  a  unit  or  vehicle  within  a  unit  lueraichy. 


Item 

Where  Type  Defined 

port  number 

int 

Standard 

echelon 

unsianed  char 

Standard 

job  desc 

unsianed  char 

Standard 

superior  id 

unsianed  short 

Standard 

sbx  unia  id 

unsianed  char 

Standard 

top  supervisor  unia  id 

unsianed  char 

Standard 

relative  id 

unsianed  char 

Standard 

inf  count 

unsianed  char 

Standard 

inferiorsiSI 

unsianed  short 

Standard 

Table  2.4-68:  VEHICLE_ECHELON_DESCRIPTOR  Structure  Definition 


The  structure  for  the  position,  appearance,  and  echelon  message  is  tagged 
vehicle_pae_tnsg.  It  contains  all  the  information  about  a  vehicle  and  only  needs  to  be  sent 
at  creation  time. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

position 

VEHICLE  POSITION  DESCRIPTOR 

Earlier  structure  in  this  file 

VEHICLE  APPEARANCE  DESCRIPTOR 

Earlier  structure  in  this  file 

1  echelon 

VEHICLE  ECHELO'  DESCRIPTOR 

Earlier  structure  in  this  file 

Table  2.4-69:  VEIIICLE_PAE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  vehicle_position_msg.  The  vehicle  position 
message  is  sent  to  update  a  vehicle's  current  position. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

position 

VEHICLE  POSITION  DESCRIPTOR 

Earlier  structure  in  this  file 

Table  2.4-70;  VEHICLE_POSITION_MSG  Structure  Definition 
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The  following  typedef  struct  is  tagged  vehicle_load_msg.  The  vehicle  load  message  is 
required  to  check  a  vehicle's  ammunition  and  fuel  loads. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

loadsfMAX  WEAPONS  ON  NETl 

Short 

Standard 

fuel 

int 

Standard 

Table  2.4-71:  VEHICLE_LOAD__MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  vehicle_position_poll_completed.  This  message  is 
needed  to  indicate  the  completion  of  the  transmitting  of  all  vehicle  position  messages  for  the 
current  round. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stnjcture  in  this  file 

Table  2.4-72:  VEHICLE_POSITION_POLL_COMPLETED_MSG  Structure 

Definition 

The  following  typedef  struct  is  tagged  vehicle_appearance_msg.  The  vehicle  appearance 
message  is  need^  to  update  a  vehicle's  appearance  when  it  gets  damaged. 


Item 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  stnjcture  in  this  file 

appearance 

VEHICLE  APPEARANCE  DESCRIPTOR 

Earlier  structure  in  this  file 

Table  2.4-73:  VEHICLE_APPEARANCE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  vehicle_echelon_msg.  The  vehicle  echelon  message 
is  sent  if  the  position  within  the  unit  hierarchy  changes. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

echelon 

VEHICLE  ECHELON  DESCRIPTOR 

Earlier  stnjcture  in  this  file 

Table  2.4-74:  VEHICLE_ECHELON_MSG  Structure  Definition 

The  following  constants  and  structures  are  used  to  print  an  arbitrary  message  at  the 
Symbolics. 


Constant 

Value 

GENERIC  MESSAGE  MAX 

1024 

Table  2.4-75:  Maximum  Characters  Constant  Definition 


Constant 

Value 

GM  RADIO  MESSAGE 

0 

GM  ERROR  MESSAGE 

1 

GM  RADIO  ALERT  MESSAGE 

2 

Table  2.4-76:  Generic  Message  Type  Constant  Definitions 
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The  following  typedef  struct  is  tagged  generic_message_msg. 


item 

Where  Tvne  Defined 

hdr 

OPFOR  HEADER 

First  structure  in  this  file 

int 

Standard 

1  messaaelGENERIC  MESSAGE  MAXI 

char 

Standard 

Table  2.4-77;  GENERIC_MESSAGE_MSG  Structure  Definition 

The  following  typedef  struct  is  tagged  stealth_position_msg.  It  is  used  to  inform  the 
Symbolics  of  the  location  of  a  stedth. 


Item 

Type 

Where  Type  Defined 

hdr 

OPFOR  HEADER 

Rrst  structure  in  this  file 

position 

VEHICLE  POSITION  DESCRIPTOR 

Earlier  structure  in  this  file 

Table  2.4-78:  STEALTH  POSITION  MSG  Structure  Definition 


2.4.2  libudp  CSC 

/simnet/libsrc/libudp 

This  library  is  used  by  the  Simhost  to  communicate  with  the  workstation,  specifically  to 
send  and  receive  the  packets.  It  uses  the  standard  UDP  protocol. 

2.4.2. 1  udp_berkeley.c  CSC 

/simnet/libsrc/libudp/udp_berkeley.c 


The  udp_berkeley.c  CSC  contains  eleven  CSUs  dealing  with  the  UDP  network  layer. 
These  CSUs  are  displayed  in  Figure  2.4-2. 


f  udp_open 

V  CSU  8.4.2. 1.1 

3C 

udp  close 

CSU  8  4.2.1. 2 

DC 

- 1 - 

udp_show  > 

CSU  8.4.2. 1.3  J 

1  -  1  - -  1  . .  .  1 _ 

r  udp_read 

V  CSU  8.4.2. 1.4 

3C 

udp  write 

CSU  84.2.1. 5 

DC 

get_local_address 

CSU  8.4.2. 1.6  J 

1  '  ■■ 

....  , 

_ L  .  .. 

(  get  remote  address 
CSU  8.4.21. 7 

)C 

print  sockaddr 
CSU  8.4.21. 8 

m 

c 


I 


make_me_non_blocking 
CSU  8.4.2.1.10 


X 


1 


maSter_udp_open 

CSU  8.4.2.1.11 


J 


Figure  2.4-2:  udp_  berkeley.c  CSC  Structure 
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2. 4. 2. 1.1  udp_open  CSU 

This  CSU  gets  the  necessary  connection  memory  block,  creates  the  UDP  socket,  makes  the 
interface  non-blocking,  and  binds  it  to  the  local  address  accompanied  by  a  unique  pon 
number  which  is  assigned  to  a  Symbolic  workstation.  This  procedure  ensures  that  only  the 
Symbolics  can  communicate  with  this  connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

local  addr 

pointer  to  char 

Standard 

int 

Standard 

1  ReturnValues  I 

Return  Value 

Type 

Meaning 

(u_ptr)  -  NULL 

pointer  to 

UDP  CONNECTION 

No  connection  block 

(ujatr)  <>  NULL 

pointer  to 

UDP  CONNECTION 

Pointer  to  connection  block 

1  Calls  1 

Function 

Where  Described 

heap  calloc 

Sec.  2.14.2.1.2 

qethostname 

Sec.  2.5.1.10 

sockaddr  init 

Sec.  2  4.2.1. 9 

socket 

make,  me  non  blockinq 

Sec.  2.4.2.1.10 

Table  2.4-79:  udp_open  CSU  [8.4.2.1.1] 


2.4.2. 1.2  udp_close  CSU 

This  CSU  closes  the  UDP  connection  and  releases  the  connection  memory  block. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

uj)tr 

pointer  to 

UDP  CONNECTION 

Sec.  2.4.2.2 

Calls 

Function 

Where  Described 

heap  deallocate 

Sec.  2.14.2.1.4 

Table  2.4-80:  udp_close  CSU  [8.4.2. 1.2] 
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2. 4. 2. 1.3  udp_show  CSU 

This  CSU  prints  the  UDP  connection  including  the  socket  and  both  local  and  remote  hosts. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

ujatr 

pointer  to 

UDP  CONNECTION 

Sec.  2.4.2.2 

Calls 

Function 

Where  Described 

print  sockaddr 

Sec.  2.4.2.1.8 

Table  2.4-81:  udp_show  CSU  [8.4.2.1.3] 


2.4.2. 1.4  udp_read  CSU 


This  CSU  attempts  to  read  the  UDP  connection  to  the  remote  port. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

u_ptr 

pointer  to 

UDP  CONNECTION 

Sec.  2.4.2.2 

buffer  Dtr 

pointer  to  char 

Standard 

max  len 

int 

Standard 

1  ReturnValues  1 

ReturnValue 

Type 

Meaning 

0 

int 

Socket  read  error  or 
handshakino 

int 

No.  of  data  bytes 

1  Errors  1 

Error  Name 

Reason  for  Error 

byte  read  ==  -1 

Error  in  UDP  socket  read 

I  Calls  I 

Function 

Where  Described 

recvfrom 

print  sockaddr 

Sec.  2.4.2.1.8 

udp  write 

Sec.  2.4.2.1.5 

Table  2.4-82:  udp_read  CSU  [8.4.2. 1.4] 
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2.4.2. 1.5  udp_write  CSU 

This  CSU  writes  to  the  sbx,  printing  messages  if  there  is  a  failure  to  write  to  the  foreign 
port  over  the  UDP,  if  there  is  a  zero  byte  length  sent,  or  if  there  is  a  short  write  to  the  sbx. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

u_ptr 

pointer  to 

UDP  CONNECTION 

Sec.  2.4.2.2 

buffer  ptr 

pointer  to  char 

Standard 

buf  len 

int 

Standard 

Calls 

Function 

Where  Described 

sendto 

print  sockaddr 

Sec.  2.4.2.1.8 

Table  2.4-83;  udp_write  CSU  [8.4.2.1.5] 


2. 4. 2. 1.6  get_local_address  CSU 
This  CSU  gets  the  address  of  the  local  host 


1  ReturnVaiues  1 

Return  Value 

Type 

Meaning 

(inet  ntoa(...)) 

pointer  to  char 

Local  host  address 

Calls 

Function 

Where  Described 

oethostname 

2.5.1.10 

gethostbyname 

2.5.1.10 

inet  ntoa 

Table  2.4-84;  get_locai_address  CSU  [8.4.2.1.6] 


2. 4. 2. 1.7  get_remote_address  CSU 

This  CSU,  given  the  host  name  as  a  string,  returns  the  internet  address  in  the  string  form 
A.B.C.D. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

hostname 

pointer  to  char 

Standard 

1  ReturnVaiues  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to  char 

Cam  get  host  name 

(inet  ntoa(...)) 

pointer  to  char 

Internet  address 
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_ _ Calls _ 

Function _ Where  Described _ 

gethostbyname _  2.5.1.10 _ 

inet  ntoa 

Table  2.4-85:  get_remote_address  CSU  [8.4.2.1.7] 


2.4.2. 1.8  print_sockaddr  CSU 


This  CSU  prints  the  socket  address  according  to  the  machine  in  use. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

Dointerto  char 

Standard 

sktp 

pointer  to  stmct  sockaddr_in 

Sec.  2.4.2.2 

Table  2.4-86:  print_sockaddr  CSU  [8.4.2. 1.8] 


2. 4. 2. 1.9  sockaddr  init  CSU 


This  CSU  initializes  the  contents  of  the  socket. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

sktp 

pointer  to  struct  sockaddr  in 

Sec.  2.4.2.2 

ascii  addr 

pointer  to  char 

Standard 

port 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

inet  addr 

htons 

Table  2.4-87:  sockaddr  init  CSU  [8.4.2.1.9] 


2.4.2.1.10  make_me_non_biocking  CSU 


This  CSU  attempts  to  make  the  mode  of  the  udp  connection  non-blocking. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

skt 

int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

-1 

int 

Non-blocking  mode  failed 

0 

int 

Non-blocking  mode 
successful 
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1  Calls  1 

Function 

Where  Described 

iocti 

Table  2.4-88:  make_me_non_blocking  CSU  [8.4.2.1.10] 


2.4.2.1.11  master_udp_open  CSU 

This  CSU  acquires  the  remote  and  the  local  addresses,  and  establishes  a  socket.  It  then 
calls  sockaddr_init  to  fill  in  the  remote  address  and  tries  to  establish  handshaking  between 
the  two  ends.  This  CSU  is  unused. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

host 

pointer  to  char 

Standarc 

port 

int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaninp 

NULL 

pointer  to 

UPD  CONNECTION 

Rermte  host  is  unknown 

uj3tr=sockaddr 

pointer  to 

UPD  CONNECTION 

Connection  successful 

u_ptr=NULL 

pointer  to 

UPD  CONNECTION 

Connection  failed 

Calls 

Function 

Where  Described 

qet  remote  address 

Sec.  2.4.2.1.7 

udp  open 

Sec.  2.4.2.1.1 

oet  local  address 

Sec.  2.4.2.1.6 

sockaddr  init 

Sec.  2.4.2.1.9 

print  sockaddr 

Sec.  2.4.2.1.8 

udp  write 

Sec.  2.4.2.1.5 

udp  read 

Sec.  2.4.2.1.4 

Table  2.4-89:  master_udp_open  CSU  [8.4.2.1.11] 


2.4. 2.2  udp_conn.h  CSU 

/simnet/libsrc/libudp/udp_conn.h 

This  CSU  is  the  UDP  layer  connection  include  file.  The  contents  are  conditional  on 
UDP_CONN_ALREADY_INCLUDE  not  being  defined. 

It  begins  by  defining  SOCKADDR_IN  as  being  a  typedef  struct  sockaddr_in.  Two  of 
these  structures  (one  foreign  and  one  local)  are  required  for  this  CSU's  one  structure 
definition,  UDP_CX)NNECTION,  which  follows. 
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Item 

Type 

Where  Type  Defined 

udp  skt 

int 

Standard 

foreian 

SOCKADDR  IN 

See  above 

local 

SOCKADDR  IN 

See  above 

Table  2.4-90:  UDP_CONNECTION  Structure  Definition 
In  addition  to  the  structure  definition,  the  CSU  contains  two  constant  definitions. 


Constant 

Value 

BUFLEN 

1471  /*  Max  ethemet  packet  lenoth  V 

DATALEN 

1400  r  Max  minus  room  for  (header  +  extra)  */ 

Table  2.4-91:  udp_conn.h  Constant  Definitions 


2. 4. 2. 3  reI_conn.c  CSC 
/simnet/libsrc/libudp/reLconn.c 

The  rel_conn.c  CSC  contains  nineteen  CSUs  (functions)  dealing  with  the  RUDP  network 
layer  connection.  These  CSUs  are  shown  in  Figure  2.4-3. 


- 1 - 

— 1 — 

- 1 

r  rudpjnit 

V  CSU  8.4.2  3. 1 

JC 

rudp  show 

CSU  8.4.2.3.2 

JC 

rudp  open  A 

CSU  8.4.2.3  3  J 

1 

_ 1 _ _ 

. n 

r  master  rudp  open 

V  CSU  8.4.2.3.4 

master_rudp  close 

CSU  8.4.2  3.6  J 

■  1  . 

1 

n 

f  rudp  synch 

V  CSU  8  4.2.3.7 

JC 

master  rudp  synch 
CSU  8.4.2.3  8 

JC 

rudp  disconnect  J 

CSU  8.4  2.3.9  J 

r 

1 

■  1 

1  f  rudp_discard_all_bufters  ^ 

rudp_read_message 

rudp_post  message 

V  CSU  8.4.2.3.10 

CSU  8.4.2.3.11 

CSU  8.4.2.3.12  ) 

^ _ 1 

1 

1 

f  rudp  send 

j  r 

has_this_packet_been_ 

rudp  ack  received  'N 

V  CSU  8.4.2.3.13 

J 

acked  CSU  8.4.2.3.14 

j 

CSU  8.4.2.3.15  J 

.  . . _ 

.  1 

. 

rudp_retransmit 
CSU  8.4.2.3.17 

JC 

rudp  send  bare  ack 

CSU  8.4.2.3.18  J 

c 


1 


rudpjick 
CSU  8.4.2.3.19 


Figure  2.4-3:  rel_conn.c  CSC  Structure 
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2. 4. 2. 3.1  rudp_init  CSU 

This  CSU  initializes  the  RUDP  socket  structure  pointed  to  by  the  input  parameter. 


Parameters 


s 


ir:- 


Parameters 


Where  Tvoedef  Declared 


inter  to  RUDP  SOCKET  I  Sec.  2.4.2.4 


Function 


et  millisecond  time 


heap  allocate 


ueue  allocate 


Calls 


Where  Described 


Sec.  2.14.3.3.2 


Sec.  2.14.2.1.4 


Sec.  2.14.4.2.1 


Table  2.4-92:  rudpjnit  CSU  [8.4.2.3.1] 


2. 4. 2. 3. 2  rudp_show  CSU 

This  CSU  prints  the  statistics  for  the  RUDP  socket  passed  in  the  parameter. 


Parameters 


s 


lliS 


Parameters 


Where  Tvoedef  Declared 


inter  to  RUDP  SOCKET  Sec.  2.4.2.4 


Function 


et  millisecond  time 


udD  show 


Calls 


Where  Described 


Sec.  2.14.3.3.2 


Sec.  2.4.2.1.3 


Table  2.4-93:  rudp_show  CSU  [8.4.2.3.2] 


2. 4. 2. 3. 3  rudp_open  CSU 

This  CSU  opens  a  UDP  connection,  gets  the  time,  and  updates  the  RUDP  socket.  If 
BENCHMARK  is  defined,  it  also  calls  the  sockaddr_init  CSU  and  bcopy. 


Parameters 


s 


local  addr 


local 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  RUDP  SOCKET  Sec.  2.4.2.4 


inter  to  char  Standard 


int  I  Standard 


idt: 
\n 
irs 


Function 


et  millisecond  time 


sockaddr  init 


Calls 


Where  Described 


Sec.  2.4.2.1.1 


Sec.  2.14.3.3.2 


Sec.  2.4.21. 9 


Table  2.4-94:  rudp_open  CSU  [8.4.2.3.3] 
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2. 4. 2. 3. 4  master_rudp_open  CSU 

This  CSU  attempts  to  establish  a  UDP  connection  and,  if  successful,  updates  the  RUDP 
socket  structure  and  synchronizes  the  two  sides  of  the  connection.  This  CSU  is  unused. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Deciared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

host 

pointer  to  char 

Standard 

port 

int 

Standard 

RetumVaiues 

Return  Value 

Type 

Meaning 

-1 

int 

No  connection 

Calls 

Function 

Where  Described 

master  udp  open 

Sec.  2.4.2.1.11 

aet  millisecond  time 

Sec.  2.14.3.3.2 

master  rudp  synch 

Sec.  2.4.2.3.8 

Table  2.4-95:  inaster_rudp_open  CSU  [8.4.2.3.4] 

2. 4. 2. 3. 5  rudp^close 

CSU 

This  CSU  closes  a  connection  through  a  call  to  udp_close. 

I  Parameters  I 

[Parameters 

Type 

Where  Typedef  Declared 

Is _ _ _ 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

Calls 

Function 

Where  Described 

udp  close 

Sec.  2.4.2.1.2 

Table  2.4-96:  rudp_close  CSU  [8.4.2.3.51 


2. 4. 2. 3. 6  master_rudp_close  CSU 


This  CSU  calls  rudp_close.  This  CSU  is  unused. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

Calls 

Function 

Where  Described 

rudp  close 

Sec.  2.4.2.3.5 

Table  2.4-97:  master_rudp_ciose  CSU  [8.4.2.3.6] 
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2. 4. 2. 3. 7  rudp_synch  CSU 

This  CSU  updates  the  RUDP  connection  state,  if  necessary,  and  synchronizes  the 
connection.  It  deletes  all  previous  data  and  resets  the  packet  sequence  numbers. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

in  sea 

unsianed  int 

standard 

out  sea 

unsianed  int 

Standard 

1  Calls  1 

Function 

Where  Described 

rudp  discard  all  buffers 

Sec.  2.4.2.3.10 

DEBUG  CONNECTION 

Table  2.4-98:  rudp_synch  CSU  [8.4.2.3.7] 


2. 4. 2. 3. 8  master_rudp_synch  CSU 

This  CSU  synchronizes  both  ends  of  the  connection,  setting  the  local  end  through  a  call  to 
CSU  rudp_synch  and  then  the  slave  end  by  allocating  and  enqueueing  a  message  buffer 
and  calling  rudp.send.  The  message  buffer  is  then  released.  This  CSU  is  unused. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

Calls 

Function 

Where  Described 

rudp  synch 

Sec.  2.4.2.3.7 

buffer  allocate 

Sec.  2.14.4.2.12 

buffer  enqueue 

Sec.  2.14.4.2.18 

rudp  send 

Sec.  2.4.2.3.13 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-99:  master_rudp_synch  CSU  [8.4.2.3.8] 


2. 4. 2. 3. 9  rudp_disconnect  CSU 

This  CSU,  if  the  RUDP  socket  connect  state  is  not  already  closed,  changes  the  state  to 
"closed"  and  discards  all  socket  buffers. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 
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1  Calls  1 

Function 

Where  Described 

rudp  discard  all  buffers 

Sec.  2.4.2.3.10 

DEBUG  CONNECTION 

Table  2.4-100:  rudp_disconnect  CSU  [8.4.2.3.9] 


2.4.2.3.10  rudp_discard_all_buffers  CSU 

This  CSU  removes  the  retransmit  queue  for  the  RUDP  socket  passed  as  a  parameter. 


I  Parameters  I 

I  Parameters 

Tvoe 

Where  Tvpedef  Declared 

[s _ _ _ 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

I  Calls  I 

Function 

Where  Described 

buffer  flush 

Sec.  2.14.4.2.23 

DEBUG  CONNECTION 

. . . 

Table  2.4-101:  rudp_discard_all_buffers  CSU  [8.4.2.3.10] 


2.4.2.3.11  rudp_read_message  CSU 

This  CSU  attempts  to  read  a  message  according  to  the  RUDP  protocol.  Acknowledgements 
for  previously  sent  messages  are  processed,  and  out  of  sequence  packets  are  ignor^. 


1  Parameters  1 

1  Parameters 

Where  Typedef  Declared 

b _ _ _ 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

1  Return  Values  I 

Return  Value 

Type 

Meanina 

0 

int 

Nothino  to  read 

-1 

int 

Out  of  sequence  or  bare  ack 

number  of  bytes  read 

int 

Number  of  message  bytes 

1  Calls  1 

Function 

Where  Described 

udp  read 

Sec.  2.4.2.1.4 

DEBUG  CONNECTION 

rudp  synch 

Sec.  2.4.2.3.7 

rudp.ack  received 

Sec.  2.4.2.3.15 

Table  2.4-102:  rudp_read_message  CSU  [8.4.2.3.11] 
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2.4.2.3.12  rudp_post_inessage  CSU 

This  CSU  enqueues  a  packet  to  be  sent,  unless  the  retransmission  queue  has  grown  too 
large.  The  message  is  wrapped  with  an  RUDP  header  and  rudp.send  is  called  to  send  out 
the  message.  The  message  is  enqueued  on  the  retransmission  queue  in  case  the  message 
must  be  retransmitted.  An  acloiowledgement  number  for  the  last  packet  received  is  included 
in  the  RUDP  header. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

data 

pointer  to  char 

Standard 

data  ten 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Meanlnp 

POST  QUEUE  FULL 

int 

Queue  full 

POST_QUEUE_WARNING 

int 

qlen  >  TRANSMIT  QUEUE 
WARNING  LENGTH 

POST  SUCCESS 

int 

Success 

1  Calls  1 

Function 

Where  Described 

queue  lenqth 

Sec.  2.14.4.2.2 

DEBUG  CONNECTION 

Sec.  2.4.2.4  See  Appendix  A 

buffer  allocate 

Sec.  2.14.4.2.12 

buffer  enqueue 

Sec.  2.14.4.2.18 

rudp  send 

Sec.  2.4.2.3.13 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4>103:  rudp_post_inessage  CSU  [8.4.2.3.12] 


2.4.2.3.13  rudp_send  CSU 

This  CSU  causes  an  RUDP  message  to  be  sent  by  the  underlying  UDP  layer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

buffer 

pointer  to  RUDP  HEADER 

Sec.  2.4.2  4 

buf  len 

int 

Standard 

Calls 

Function 

Where  Described 

udp  write 

Sec.  2.4.2.1.5 

Table  2.4>104:  rudp_send  CSU  [8.4.2.3.13] 
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2.4.2.3.14  has_this_packet_been_acked  CSU 

This  CSU  checks  whether  an  acknowledgement  for  this  packet  has  been  received. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

rh  Dtr 

pointer  to  RUDP  HEADER 

Sec.  2.4.2.4 

ack 

unsianed  int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

1 

int 

Acknowledgement  received 

0 

int 

No  acknowledgement 
received 

Table  2.4-105:  has_this_packet_been_acked  CSU  [8.4.2.3.14] 


2.4.2.3.15  rudp_ack_received  CSU 

This  CSU  searches  through  all  of  the  packets  in  the  retransmission  queue  and  removes  all 
those  that  have  a  sequence_id  less  than  or  equal  to  the  acknowledgement  id  received. 
Acknowledgements  are  cumulative.  An  acknowledgement  for  a  packet  with  a  sequence  id 
of  "n"  is  an  implicit  acknowledgement  for  all  ptu;kets  with  sequence  numbers  less  than  "n". 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

ack 

unsigned  int 

Standard 

1  Calls  1 

Function 

Where  Described 

DEBUG  CONNECTION 

Sec.  2.4.2.4  See  Appendix  A 

buffer  traverse  and  apply 

Sec.  2.14.4.2.21 

queue  length 

Sec.  2.14.4.2.2 

buffer  dequeue 

Sec  2.14.4.2.20 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-106:  rudp_ack_received  CSU  [8.4.2.3.15] 


2.4.2.3.16  rudp_retransmit_buf  CSU 

This  CSU  resends  a  packet. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

hp 

pointer  to  RUDP  HEADER 

Sec.  2  4.2.4 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2  4 

86 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


1  ReturnVatues  I 

Return  Value 

Type 

Meanina 

1 

int 

Execution  was  completed 

I  Calls  I 

Function 

Where  Described  I 

DEBUG  CONNECTION 

M  gjf  :T:f If .! 

rudp  send 

Sec.  2.4.2.3.13 

buffer  lenath 

Sec.  2.14.4.2.16 

Table  2.4-107:  rudp_retransinit_buf  CSU  [8.4.2.3.16] 


2.4.2.3.17  rudp_retransmit  CSU 


This  CSU  resends  all  packets  in  the  retransmission  queue  (that  is,  all  packets  not  yet 
acknowledged).  If  there  are  no  packets  to  be  retransmitted,  a  bare  ACK  (acknowledge)  is 
transmitted  so  that  the  Symbolics  receives  a  steady  stream  of  acknowledges. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

1  Calls  1 

Function 

Where  Described 

buffer_traverse_and_apply_ 
n  times 

Sec.  2.14.4.2.22 

DEBUG  CONNECTION 

rudp  send  bare  ack 

Sec.  2.4.2.3.18  1 

Table  2.4-108:  rudp_retransmit  CSU  [8.4.2.3.17] 


2.4.2.3.18  rudp_send_bare_ack  CSU 

This  CSU  sends  an  RUDP  packet  with  no  data  in  it  It  contains  an  ACK  for  the  last  packet 
received. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 
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1  Calls  1 

Function 

Where  Described  1 

DEBUG  CONNECTION 

rudp  send 

Sec.  2.4.2.3.13  1 

Table  2.4.109:  rudp_send_bare_ack  CSU  [8.4.2.3.18] 
2.4.2.3.19  rudpjick  CSU 

This  CSU  causes  retransmissions  if  the  retransmission  time  has  expired. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2  4 

Calls 

Function 

Where  Described 

rudD  ack  received 

S^C.  2.4.2.3.15 

rudp  retransmit 

Sec.  2.4.2.3.17 

Table  2.4-110:  rudpjick  CSU  [8.4.2.3.19] 


2. 4. 2. 4  reljonn.h  CSU 

/simnet/libsrc/libudp/rel_conn.h 

This  CSU  contains  the  reliable  connection  layer  includes  for  the  Symbolics/MIPS 
connection.  It  contains  two  typedef  structures,  a  number  of  constant  definitions,  other 
external  and  local  definitions,  and  a  macro  (DEBUG_CONNECnON(x))  defined  in 
Appendix  A, 


litem 

Type 

Where  Type  Defined 

int 

Standard 

sea 

int 

Standard 

ack 

int 

Standard 

Table  2.4-111:  RUDP_HEADER  Structure  Definition 
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Item 


connection  state 


next  retransmit  time 


next  r^o  out 


last  sea  in 


last  seci  ret 


need  ack 


tr 


ackets  out 


ackets  in 


bare  acks 


ackets  retransmitted 


ackets  tossed 


sbx  oackets  tossed 


marked  total  bvtes  out 


marked  total  bvtes  in 


marked  new  bvtes  out 


marked  new  bvtes  in 


last  marked  time 


input  buffer 


retransmit  aueue 


last  svnched 


int 


unsianed  int 


unsianed  int 


unsianed  int 


unsianed  int 


int 


inter  to  UDP  CONNECTION 


int 


int 


int 


int 


int 


int 


int 


int 


int 


int 


unsianed  int 


inter  to  char 


inter  to  char 


inter  to  OUEUE 


int 


Where  Type  Defined 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Sec.  2.4.2.2 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Sec.  2.14.4.3 


Standard 


Table  2.4-112:  RUDP  SOCKET  Structure  Definition 


Constant 

Value 

RUDP  TYPE  SYNCH 

1 

RUDP  TYPE  DATA 

2 

RUDP  TYPE  ACK 

3 

SHORT  RETRANSMIT  TIME 

500  r  Milliseconds  */ 

NORMAL  RETRANSMIT  TIME 

6000  /*  Milliseconds  V 

CONNECT  STATE  OPEN 

1 

CONNECT  STATE  CLOSED 

2 

CONNECT  STATE  LOADED 

3 

TRANSMIT  QUEUE  WARNING  LENGTH 

40 

TRANSMIT  QUEUE  ERROR  LENGTH 

100 

RETRANSMISSION  BURST  LENGTH 

10 

POST  SUCCESS 

0 

POST  CONNECTION  CLOSED 

1 

POST  QUEUE  FULL 

2 

POST  QUEUE  WARNING 

3 

D  CONNECTION  /*  Debua  connection  bit  */ 

0x00004000 

Table  2.4-113:  rel  conn.h  Constant  Definitions 
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2. 4. 2. 5  buf_conn.c  CSC 
/simnet/libsic/libudp/buf_conn.c 

The  buf_conn.c  CSC  contains  thirteen  CSUs  (functions)  dealing  with  the  Buffered  RUDP 
netwodc  layer.  These  CSUs  are  shown  in  Figure  2.4-4.  Outgoing  packets  are  buffered 
together  into  pieces  that  just  fit  into  an  RUDP  packet.  This  maximizes  the  amount  of  useful 
data  in  each  RUDP  packet. 


1  _ 1 _ 

-  I _ 

r  but  rudp  init  A  ^ 

V  CSU8.4.2.5.1  J  V 

bufjrudp  show 
CSU  8.4  2.5.2 

:)c 

but  rudp  open  A 

CSU  8.4.2.5.3  J 

I  - - 

I 

I 

r  but  master  rudp  open  A  r 
K  CSU8.4.2.S.4  J  V 

buf  master  rudp  synch 
CSU  8.4.2.55 

3C 

buf_rudp_close  A 

CSU  8.4.2.5.6  J 

_ I  ~ _  ■■ 

I 

r  buf_master_rudp_close  'N  ^but  rudp  discard  all  buffer^  f 

V  CSU8.4.2.5.7  J  V  CSU  8.4.2.5  8  J  V _ 

buf  rudp  disconnect  A 
CSU  8  4.2.5.9  J 

c 


buf_rudp_flush 
CSU  8.4.2.S.10 


1 


^  f  buf_rudp_read_message  A  f  buf_rudp_write_message  A 
^  CSU8.4.2.S.11  J  ^  CSU8.4.2.S.12  J 


(buf_rudp  tick  ^ 

CSU8.4  2~5.13  J 

Figure  2,4-4:  buf_conn.c  CSC  Structure 


2. 4. 2. 5.1  buf_rudp_init  CSU 

This  CSU  initiates  the  buffered  RUDP  socket. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4  2.6 

Calls 

Function 

Where  Described 

heap  allocate 

Sec.  2.14.2.1.1 

Queue  allocate 

Sec.  2.14.4.2.1 

rudp  init 

Sec.  2.4.2.3.1 

Table  2.4-114:  buf_rudp_init  CSU  [8.4.2.5.1] 
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2. 4. 2. 5. 2  buf_rudp_show  CSU 


This  CSU  prints  statistics  on  this  layer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

Calls 

Function 

Where  Described 

queue  length 

Sec.  2.14.4.2.2 

rudp  show 

Sec.  2.4.2.3  2 

Table  2.4*115:  buff_rudp_show  CSU  [8.4.2.5.2] 


2. 4. 2. 5. 3  buf_rudp_open  CSU 

This  CSU  opens  this  layer  by  initializing  the  idle  timer  and  opening  the  RUDP  layer. 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

locaLaddr 

pointer  to  char 

Standard 

int 

Standard 

1  Calls 

Function 

Where  Described 

rudp  open 

Sec.  2.4.2.3.3 

get  millisecond  time 

Sec.  2.14.3.3.2 

Table  2.4-116:  buf_rudp_open  CSU  [8.4.2.5.3] 


2. 4. 2. 5. 4  buf_master_rudp_open  CSU 

This  CSU  is  unused. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2  4.2.6 

host 

pointer  to  char 

standard 

port 

int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

-1 

int 

Connection  failed  to  open 
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1  Calls  1 

Function 

Where  Described 

master  aidp  open 

Sec.  2.4.2.3  4 

aet  millisecond  time 

Sec.  2.14.3.3.2 

Table  2.4-117: 

buf_master_rud  p_open 

CSU  [8.4.2.5.4] 

2. 4. 2. 5. 5  buf_inaster_rudp_synch  CSU 

This  CSU  is  unused. 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2  4.2.6 

Calls 

Function 

Where  Described 

but  rudp  discard  all  buffers 

Sec.  2.4.2.5.8 

master  rudp  synch 

Sec.  2.4.2.3.8 

Table  2.4-118:  buf_master_rudp_synch  CSU  [8.4.2.5.5] 
2. 4. 2. 5. 6  buf_rudp_close  CSU 

This  CSU  closes  the  connection  by  closing  the  RUDP  layer. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

1  Calls  1 

Function 

Where  Described 

rudp  close 

Sec.  2.4.2  3.5 

Table  2.4-119:  buf_rudp_close  CSU  [8.4.2.5.6] 


2. 4. 2. 5. 7  buf_master_rudp_close  CSU 
This  CSU  is  unused. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 
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1  Calls  1 

Function 

Where  Described 

master  rudp  close 

Sec.  2.4.2.3.6 

Table  2.4*120:  buf_master_rudp_close  CSU  [8.4.2.5.7] 


2. 4. 2. 5. 8  buf_rudp_discard_all_buffers  CSU 

This  CSU  discards  any  buffered  messages  waiting  to  be  retransmitted. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

1  Calls  1 

Function 

Where  Described  1 

DEBUG  CONNECTION 

buffer  flush 

Sec.  2.14.4.2.23  1 

Table  2.4-121:  buf_rudp_discard_all_buffers  CSU  [8.4.2.5.8] 


2. 4. 2. 5. 9  buf_rudp_disconnect  CSU 

This  CSU  disconnects  this  connection  by  disconnecting  the  RUDP  layer.  Buffered 
messages  are  disabled. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

Calls 

Function 

Where  Described 

buf  mdp  discard  all  buffers 

Sec.  2.4.2.5.8 

rudp  disconnect 

Sec.  2.4.2.3.9 

Table  2.4-122:  buf_rudp_disconnect  CSU  [8.4.2.5.9] 


2.4.2.5.10  buf_rudp_flush  CSU 


This  CSU  sends  the  currently  buffered  messages  to  the  RUDP  layer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 
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1  ReturnValues  I 

Return  Value 

Meanina 

FALSE 

int 

Buffer  empty 

TRUE 

int 

Buffer  was  not  empty 

1  Calls  1 

■  Function 

Where  Described 

Sec.  2.4.2.3.12 

Table  2.4.123:  buf_rudp_flush  CSU  [8.4.2.5.10] 


2.4.2.5.11  buff_rudp_read_message  CSU 

This  CSU  enters  a  loop  until  there  is  either  a  valid  message  for  the  RUDP  layer  or  there  is 
nothing  to  read. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

pointer  to  pointer  to  char 

Standard 

imsa  len 

pointer  to  int 

Standard 

1  Calls  1 

Function 

Where  Described 

rudp  read  messaqe 

Sec.  2.4.2.3.11 

buf  rudp  discard  all  buffers 

Sec.  2.4.2.5.8 

Table  2.4*124:  buff_rudp_read_message  CSU  [8.4.2.5.11] 


2.4.2.5.12  buf_rudp_write_message  CSU 

If  there  is  room  in  the  currently  buffered  message,  this  CSU  adds  the  input  message  to  the 
buffered  message.  Otherwise,  the  currently  buffered  message  is  removed  (via 
buf_rudp_flush)  and  a  new  buffered  message  is  staned  with  the  input  message  as  the  first 
component. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec  2.4.2.6 

buffer 

pointer  to  char 

Standard 

buf  len 

int 

Standard 

Calls 

Function 

Where  Described 

buf  rudp  flush 

Sec.  2.4.2.5.10 

Table  2.4-125:  buf_rudp_wrile  message  CSU  [8.4.2.5.12] 
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2.4.2.5.13  buf_rudp_tick  CSU 

This  CSU  pulls  messages  off  the  input  queue  and  writes  these  messages  via 
buf_rudp_write_message.  If  the  idle  time  has  elapsed,  the  currently  buffered  message  is 
sent,  preventing  a  buffered  message  from  waiting  indefinitely  for  enough  messages  to  fill 
the  RUDP  packet  before  it  is  sent.  The  RUDP  layer  is  ticked. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

1  Calls  1 

Function 

Where  Described 

queue  length 

Sec.  2.14.4.1.3 

buffer  dequeue 

Sec.  2.14.4.2.20 

buf  rudp  write  message 

Sec.  2.4.2.5.12 

buffer  length 

Sec.  2.14.4.2.16 

buffer  deallocate 

Sec.  2.14.4.2.15 

DEBUG  CONNECTION 

get  millisecond  time 

Sec.  2.14.3.3.2 

buf  rudp  flush 

Sec.  2.4.2.5.10 

rudp  tick 

Sec.  2.4.2.3.19 

Table  2.4-126:  buf_rudp_tick  CSU  [8.4.2.5.13] 

2.4. 2.6  buf_conn.h  CSU 

/simnet/libsrc/libudp/buf_conn.h 

This  CSU  consists  of  the  buffered  connection  includes.  These  includes  consist  of  a 
typedef  struct  and  two  constant  defines. 

The  typedef  struct  is  tagged  buf_rudp_socket. 


Item 

Type 

Where  Type  Defined 

send  buffer  offset 

int 

Standard 

next  idle  time 

unsigned  int 

Standard 

message  in 

int 

Standard 

message  out 

int 

Standard 

idle  flushes 

int 

Standard 

send  buffer 

pointer  to  char 

Standard 

input  queue 

pointer  to  QUEUE 

Sec.  2.14.4.3 

rudp  skt 

pointer  to  RUDP  SOCKET 

Sec.  2.4.2.4 

Table  2.4-127:  BUF  RUDP  SOCKET  Structure  Dermition 


Constant 

Value 

BUF  RUDP  IDLE  DURATION 

1000 

INPUT  QUEUE  WARNING  LENGTH 

256 

Table  2.4-128:  buf_conn.h  Constant  Definitions 
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2.4.3  SAF  Command  Processor  CSC 

2. 4. 3.1  map.c  CSC 

/simnet/sTc/host/map.c 

This  file  handles  the  symbol  mapping  between  the  woiitstation  and  Simhost.  The  map.c 
CSC  structure,  consisting  of  nine  CSUs,  is  depicted  in  Figure  2.4-5. 


map.c 

CSC 

8.4.3.1 


1  1  '  - 

-  - 1 _ 

r  init  mappings 

V  CSU  8.4.3. 1.1 

^ap  loon  symbol  to  icon  ^ 
J  V  number  CSU  8.4.3. 1.2  J 

f  map_echelon_symbol_to_' 
echelon  number 

k.  CSU8.4.3.1.3 

1 

1 

1 

^  map_echelon_numbGr_ 
1  to  echelon  symbol 

V  'CSU8.4.3.1.4 

’N  ^ap_echelon_type_symbolA 

1  1  to  echelon  type  number  I 
J  \ _ CSU  8.4.3.1.5 _ J 

^nap_echelon_type_number_ 
to  echelon  type  symbol 
_ CSU  8.4.3.1.6 _ > 

1 _ 

C 


map_echelon_lypa_symbol_ 
to_icon_number 
CSU  874.3. 1.7 


rassoc  sym 
CSU  8A3.1.8 


Xicon_from_object_type 

CSU8.4.3.1.9  J 


Figure  2.4-5:  map.c  CSC  Structure 


2. 4. 3. 1.1  init_mappings  CSU 

This  CSU  reads  the  mapping  file  and  initializes  the  various  mappings. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

filename 

pointer  to  char 

Standard 

Errors 

Error  Name 

Reason  for  Error 

Mappina  file  not  found. 

Ireader  read  file(filename.&db) 

Calls 

Function 

Where  Described 

reader  read  file 

Sec.  2.1. 1.1 .7 

ERROR  OUT 

Sec.  2.5.2.2 

abort 

find  taa 

Sec.  2.1 .1.4.3 

map_echelon_symbol„to_ 
echelon  number 

Sec.  2.4.3.1.3 

Table  2.4-129:  init_mappings  CSU  [8.4.3.1.11 


96 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2. 4. 3. 1.2  inap_icon_symbol_to_icon_number  CSU 


This  CSU  maps  an  icon  name  into  an  icon  number. 


1  Parameters  1 

1  Parameters 

Type 

Where  Typedef  Declared 

Isvm 

pointer  to  char 

Standard 

ReturnVaiues 

Return  Value 

Type 

Meanlnp 

0 

unsiqned  short 

Icon  name  unknown 

resultf21.inteaer 

unsianed  short 

Icon  number 

Calls 

Function 

Where  Described 

findtaa 

Sec.  2.1 .1.4.3 

Table  2.4-130:  map_icon_symbol_to_icon_number  CSU  [8.4.3.1.2] 


2. 4. 3. 1.3  map_echelon_symbol_to_echeIon_number  CSU 
This  CSU  maps  an  echelon  name  into  an  echelon  number. 


Table  2.4-131:  map_echelon_symbol_to_echelon_number  CSU  [8.4.3.1.3] 
2. 4. 3. 1.4  map_echelon_number_to_echelon_symbol  CSU 


This  CSU  maps  an  echelon  number  into  an  echelon  name. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

num 

unsiqned  char 

Standard 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sym 

pointer  to  char 

Standard 

ReturnVaiues 

Return  Value 

Meaning 

0 

unsigned  short 

Echelon  name  unknown 

resultr21.integer 

unsigned  short 

Echelon  number 

1  Calls  1 

Function 

Where  Described 

find  taq 

Sec.  2.1 .1.4.3 
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1  ReturnValues  1 

Return  Value 

Type 

Meanina 

rassoc_sym(num,echelon_ 

man) 

pointer  to  char 

Pointer  to  echelon  name 

Calls 

Function 

Where  Described 

rassoc  sym 

Sec.  2.4.3. 1.8 

Table  2.4-132:  inap_echelon_number_to_echelon_syinbol  CSU  [8.4.3.1.4] 

2. 4. 3. 1.5  inap_echeIon_type_symboMo_echeIon_type_number  CSU 
This  CSU  maps  an  echelon  type  name  into  an  echelon  type  number 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

svm 

pointer  to  char 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

0 

unsianed  short 

Echelon  type  name  unknown 

resultf21.inteqer 

unsigned  short 

Echelon  type  number 

1  Calls  1 

Function 

Where  Described 

find  taq 

Sec.  2.1. 1.4.3 

Table  2.4-133:  map_echelon  type  symbol  to  echelon  type_numbcr  CSU 

"[8.C3.1.53"  " 


2. 4. 3. 1.6  map_echelon_type_number_to_echelon_type_symbol  CSU 
This  CSU  maps  an  echelon  type  number  into  an  echelon  type  name. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

num 

unsigned  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

rassoc_sym(num,echelon_ . 
type  map) 

pointer  to  char 

Pointer  to  echelon  type  name 
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\  Calls  1 

Function 

Where  Described 

rassoc  sym 

Sec.  2.4.3.1.8 

Table  2.4*134:  map  echelon  type  number  to  echelon  type  symbol  CSU 

"[8.^.3.1.61 


2. 4. 3. 1.7  map_echelon_type_symbol_to_icon_number  CSU 
This  CSU  maps  an  echelon  type  name  into  an  icon  number. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

sym 

pointer  to  char 

Standard 

I  ReturnVaiues  I 

Return  Value 

Meaning 

0 

unsigned  short 

Echelon  type  name  unknown 

mapJcon_symboUoJcon_ 
number! resultF21.charptr) 

unsigned  short 

Icon  number 

1  Calls  1 

Function 

Where  Described 

find  tag 

Sec.  2.1. 1.4.3 

mapjcon_symbol_tojcon_ 

number 

Sec.  2.4.3.1.2 

Table  2.4*135:  map  echelon_type  symbol  to  icon  number  CSU 

[8.4.3. 1.7] 


2. 4. 3. 1.8  rassoc_sym  CSU 


This  CSU  does  an  inverse  association  from  the  mapping  file.  It  finds  the  name  that  maps  to 
the  input  number. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

num 

unsigned  char 

Standard 

table 

pointer  to  DATA UNION 

1  ReturnVaiues  1 

1  Return  Value 

Type 

Meaning 

pointer  to  char 

Pointer  to  the  name 

IUNKNOWN  SYM 

pointer  to  char 

No  name  found 

Table  2.4*136:  rassoc_sym  CSU  [8.4.3.1.8] 
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2.4.3. 1.9  icon_from__object_type  CSU 


This  CSU  classifies  objects  of  the  input  object  type  into  a  valid  icon  number. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

obi 

ObiectTvpe 

p  sim.h 

ReturnValues 

Return  Value 

Type 

Meaning 

0 

unsianed  short 

Unknown  input 

map  icon  symbol  to  icon 
numberlFWA  SYM) 

unsigned  short 

Icon  number  of  Fixed  Wing 
symbol 

map  icon  symbol  to  icon 
numberlSCOUT  RWA  SYM) 

unsigned  short 

loon  number  of  Scout  Rotary 
Wing  symbol 

map_icon_symboLtoJcon_ 
number(ATTACK  RWA 

SYM) 

unsigned  short 

Icon  number  of  Attack  Rotary 
Wing  symbol 

mapJcon_symboLtoJcon_ 
number(AOA  SYM) 

unsigned  short 

Icon  number  of  Anti  Aircraft 
symbol 

map_icon_symboLtoJcon_ 

number(MECH_SYM) 

unsigned  short 

Icon  number  of  Personnel 
Carrier  or  Ground  Recon 
symbol 

map  icon  symbol  to  icon 
numberfCP  SYM) 

unsigned  short 

Icon  number  of  Command 

Post  symbol 

map  icon  symbol  to  icon 
numbedSPH  SYM) 

unsigned  short 

Icon  number  of  Howitzer 
symbol 

map  icon  symbol  to  icon 
numberlMORTAR  SYM) 

unsigned  short 

Icon  number  of  Mortar  symbol 

map  icon  symbol  to  icon 
numbedSUPPLY  SYM) 

unsigned  short 

icon  number  of  Recovery 
symbol 

map  icon  symbol  to  icon 
numberlAMMO  SYM) 

unsigned  short 

Icon  number  of  ammo  Supply 
Truck  symbol 

map  icon  symbol  to  icon 
number(FUEL  SYM) 

unsigned  short 

Icon  number  of  fuel  Supply 
Tnjck  symbol 

map  icon  symbol  to  icon 
number(TANK  SYM) 

unsigned  short 

Icon  number  of  Main  Battle 

Tank  symbol 

Calls 

Function 

Where  Described 

mapJcon_symboLtoJcon_ 

number 

Sec.  2.4.3. 1.2 

Table  2.4-137:  icon_from_object_type  CSU  [8.4.3.1.9] 
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2. 4. 3. 2  sbx.c  CSC 
/simnet/src/host/sbx.c 

This  CSC  contains  all  the  code  that  handles  communications  with  the  woricstation. 


open_io_connections 
CSU  8.4.3.2.1 


show_connection_all_sbx 
CSU  8.4.3.2.4 


show_overlays_all_sbx 
CSU  8.4.3.2.7 


exit_alljsbx_conns 
CSU  8.4.3.2.2 


gel_8bxJrom _port 
CSU  8.4.3.2.5 


sbx_prinl( 
CSU  8.4.3.2.8 


write_buffer_all_sbx 
CSU  8.4.3.2.3 


poll_request_to_string 
CSU  8.4.3.2.6 


sbx_connectionJnit 
CSU  8.4.3.2  9 


sbx_connection_opan 
CSU  8.4.3.2.10 


sbx_connection_synch_ 
received  CSU  8.4.3.2.13 


sbx_connection_send_to_ 
port  CSU  8.4.3.2.19 


sbx_connection_process_ 
indirect  fire  CSU  8.4.3.2.22 


vehicleJmpact_to_sbx 
CSU  8.4.3.2.25 


country_to_string 
CSU  8.4.3.2.28 


sbx_connection_exit 
CSU  8.4.3.2.11 


sbx_connectk)n_disconn 
CSU  8.4.3.2.14 


sbx_connection_tick 
CSU  8.4.3.2.17 


sox_connection  _process_v 
hiclejmpact  CSU  6.4.3.2.20 


indirect_fire_to_sbx 
CSU  8.4.3.2.23 


sbx_connection_process_ 
messaoe  CSU  8.4.3.2.26 


sbx_connection_create_unit. 
msg  CSU  8.4.3.2.29 


sbx_connection_write_buffer 
CSU  8.4.3.2.15 


fill_sbx_opfor_header 
CSU  8.4.3.2.18 


sbx_connection_process_jgro' 
und  impact  CSU  8.4.3.2.21 


groundJmpact_to_sbx 
CSU  8.4.3.2.24 


sbx_connection _process_ 
messages  CSU  8.4.3.2.27 


sbx_connection_reset_msg 
CSU  8.4.3.2.30 


sbx_connection^enerate_ 
reset  vehicle  CSU  8.4.3.2.31 


sbx_connection_vehicle 
reinit  CSU  84.3.2.32 


sbx_connection_servce_ 
poll_msg  CSU  8.4.3.2.33 


sbx_oonnection_wat_pulse 
CSU  8.4.3.2.34 


sbx_connection_stat _pulse 
CSU  8.4.3.2.35 


sbx_connection_query_sub_ 
state  CSU  8.4.3.2.38 


arty_type_string 
CSU  8.4.3.2.36 


sbx_connection_set_ivis_ 
xmit  modes  CSU  6.4.3.2.39 


Figure  2.4-6:  sbx.c  CSC  Structure  Part  1  of  2 
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f  8bx_connection_s8tJvis_  ^  / 
Voarameters  CSU  8.4.3.2.40  y  ' 

^  sbx  swap  known  vehicles  A  f  sbx  set  all  known  vehicles^ 
L  CSU  8.4.3.2.41  J  V  CSU  8.4.3.2.42  J 

r  sbx  set  specific  known  ^  ^ 
V  vehicles  CSU  8.4.3.2.43  J 

^sbx  sat  top  level  known  ^  f  sbx  add _point  ^ 

C§V  9.4.3.2.44  V  CSU  8.4.3.2.45  J 

f  sbx  add  area  ^  . 

V  CSU  8.4.3.2.46  J 

^  sbx  add  zone  A  f  sbx  add  line  ^ 

1  CSU  8.4.3.2.47  J  V  CSU  8.4.3.2.48  J 

f  sbx  add  route  ^ 

V  CSU  8.4.3.2.49  J 

^  sbx  delete  overlay  A  r  sbx  execute  overlay 

L  CSU  8.4.3.2.50  J  V  CSU  8.4.3.2.51  J 

^  sbx_change  speed  A  f  sbx_change  formation  ^ 
^  CSU  8.4.3.2.53  J  V  CSU  8.4.3.2.54  J 

r  sbx  delete  cm 

V  CSU  8.4.3.2.55  J 

✓ - ^ - N.  ✓ - ^ N 

^  sbx  rejoin  unit  A  A  sbx  follow  vehicle  ^ 

^  CSU  8.4.3.2.56  J  V  CSU  8.4.3.2.57  J 

. - 1 - 

f  sbx  simulator  in  commanoN 

V  CSU  8.4.3.2.58  J 

^  sbx_floto_point  A  r  sbx  resume  mission 

^  CSU  8.4.3.2.59  J  V  CSU  8.4.3.2.60  J 

^sbx  set  targeting  oarameA  f  sbx  land 

^  tens  CSU  8.4.3.2.62  J  V  CSU  8!4.3.2.63 

^  sbx  altitude  A  f  string  for  hold  type 

CSU  8.4.3.2.65  J  V  CSU  8.4.3.2.66  yi 

f  sbx  hold  ^ 

V  CSU  8.4.3.2.67  J 

^  1 - ^  ^  J - - 

^  string  for  attack  type  A  A  sbx  attack  ^ 

1  CSU  8.4.3.2.68  J  V  CSU  8.4.3.2.69  J 

A  broadcast  appearance  A  , 
V  data  CSU  8.4.3.2.73  J 

f  broadcast_pae  data  A  A  broadcast  veh  is_£ 
CSU  8.4.3.2.74  J  \  CSU  8.4.3.2.75 

A  print  opfor  header  A  , 
V  CSU  8.4.3.2.76  J 

pnnt  message_position  l  (  print  vehicle  id 

^  CSU  8.4.3.2.77  J  V  CSU  8.4.3.2.78 

_ _ 1 _ ^ 

A sbx  connection  show  top  A 

VJevel  units  CSU  8.4.3.2.79  J 
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2. 4. 3. 2.1  open_io_connections  CSU 

This  CSU  opens  all  the  specified  ports  and  schedules  the  sbx_connnection  tick  to  be  ticked 
every  100  milliseconds. 


1  Parameters  I 

1  Parameters 

Type 

Where  Tvpedef  Declared 

1  port  array!  1 

int 

Standard 

Calls 

Function 

Where  Described 

allocate  sbx  connection 

Sec.  2.4.3.3 

sbx  connection  init 

Sec.  2.4.3.2.9 

sbx  connection  open 

Sec.  2.4.3.2.10 

get  local  address 

Sec.  2.4  2.1. 6 

periodic  fnci 

Sec.  2.2.1. 1.2 

Table  2.4-138:  open_io_connections  CSU  [8.4.3.2.1] 


2. 4. 3. 2. 2  exit_all_sbx_conns  CSU 

This  CSU  causes  all  ports  to  be  closed. 


I 


1  Calls  1 

Function 

Where  Described 

sbx  connection  exit 

Sec.  2.4.3.2.11 

Table  2.4-139:  exlt_all_sbx  conns  CSU  [8.4.3.2.2] 


2. 4. 3. 2. 3  wrUe_buffer_all_sbx  CSU 
This  CSU  writes  a  message  to  all  open  ports. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

bufp 

pointer  to  OPFOR  HEADER 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

Table  2.4-140:  write_buffer_all_sbx  CSU  [8.4.3.2.3] 


I 
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2. 4. 3. 2. 4  show_connection_all_sbx  CSU 

This  CSU  causes  all  open  ports  to  display  status  information. 


1  Calls  1 

Function 

Where  Described 

sbx  connection  show 

Sec.  2.4.3.2.12 

Table  2.4*141:  show_connection_all_sbx  CSU  [8.4.3.2.4] 


2. 4. 3. 2. 5  get_sbx_froin_port  CSU 

This  CSU  returns  the  SBX_CONNECnON_VARS  corresponding  to  the  given  port  id. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

port 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

sbx_connections[i] 

pointer  to 

SBX  CONNECTION  VARS 

Pointer  to  block  of  connection 
variables 

NULL 

pointer  to 

SBX  CONNECTION  VARS 

Port  id  unknown 

Table  2.4*142:  get_sbx_froin_port  CSU  [8.4.3.2.5] 


2. 4. 3. 2. 6  poll_request_to_string  CSU 

This  CSU  returns  a  human  readable  string  identifying  what  type  of  poll  request  has  been 
received. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

req 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Meaning 

"Gods  Eye  View" 

pointer  to  char 

God's  view  poll  request 
received 

"Commanders  Eye  View" 

pointer  to  char 

Commander's  view  poll 
request  received 

"Specific  Request" 

pointer  to  char 

Specific  poll  request  received 

"Unknown  request" 

pointer  to  char 

Unknown  poll  request 
received 

Table  2.4-143:  poll_requcst_to_string  CSU  [8.4. 3.2.6] 
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2. 4. 3. 2. 7  show_overlays_aII_sbx  CSU 

This  CSU  causes  all  overlays  associated  with  each  port  to  be  displayed. 


1  Calls  1 

Function 

Where  Described 

show  overlays 

Sec.  2.10.2.1.34 

Table  2.4*144:  show_overlays_all_sbx  CSU  [8.4.3.2.7] 


2. 4. 3. 2. 8  sbx_printf  CSU 

This  CSU  causes  a  string  message,  in  the  form  of  a  printf  string  with  arguments,  to  be  sent 
to  the  specified  port. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

vid 

unsigned  int 

Standard 

messaae  type 

unsigned  short 

Standard 

port 

int 

Standard 

format  strinq 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

sbx_connection_send_to_ 

port 

Sec.  2.4.3.2.19 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-145;  sbx_printf  CSU  [8.4.3.2.8] 


2. 4. 3. 2. 9  sbx_connection_init  CSU 

This  CSU  initializes  all  the  data  structures  for  a  port.  The  view  is  initialized  to  be 
commander. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4  3.3 

Calls 

Function 

Where  Described 

sbx  connection  stat  pulse 

Sec.  2.4.3.2.35 

heap  allocate 

Sec.  2.14.2.1.1 

allocate  bitfield 

Sec.  2.14.3.4.1 

clear  bitfield 

Sec.  2.14.3.4.6 

buf  rudp  init 

Sec.  2.4.2.5.1 

Table  2.4*146:  sbx  connection  init  CSU  [8.4.3.2.91 
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2.4.3.2.10  sbx_connection_open  CSU 

This  CSU  opens  the  port  associated  with  an  sbx_connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

local  addr 

pointer  to  char 

Standard 

local  port 

int 

Standard 

Calls 

Function 

Where  Described 

buf  rudp  open 

Sec.  2.4.2.5.3 

Table  2.4>147:  sbx_connectioii_open  CSU  [8.4.3.2.10] 


2.4.3.2.11  sbx_connection_exit  CSU 

The  CSU  closes  the  port  associated  with  an  sbx_connection. 


i  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

Calls 

Function 

Where  Described 

buf  rudp  close 

Sec.  2  4.2.5.6 

DEBUG  CONNECTION 

Sec.  2A.2.4  See  Appendix  A 

Table  2.4-148:  sbx  connection  exit  CSU  [8.4.3.2.11] 


2.4.3.2.12  sbx_connection_show  CSU 

This  CSU  causes  various  statistics  concerning  an  sbx_connection  to  be  printed. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4  3.3 

1  Errors  1 

Error  Name 

Reason  for  Error 

connection  in  unknown  state 

SBX  connection  is  neither  open,  nor  closed,  nor  loaded. 
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1  Calls  1 

Function 

Where  Described 

poll  request  to  strinq 

Sec.  2.4.3.2.6 

forcelD  to  strinq 

Sec.  2.9.2.1.3 

sbx_connection_show_top_ 
level  units 

Sec.  2.4.3.2.79 

but  rudp  show 

Sec.  2  4.2.5.2 

ERROR  OUT 

Sec.  2.5.2.2 

Table  2.4-149:  sbx_connection_show  CSU  [8.4.3.2.12] 


2.4.3.2.13  sbx_connection_synch_received  CSU 

This  CSU  causes  a  MACHINE_STATUS  message  to  be  sent  to  the  Symbolics  when  a 
connection  is  established.  A  deferred  function  is  started  to  cause  the  sending  of  PAE 
messages. 


I  Parameters  I 

Parameters 

Where  Tvpedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

I  Calls  I 

Function 

Where  Described 

sbx  connection  stat  pulse 

Sec.  2.4.3.2.35 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

qet  millisecond  time 

Sec.  2.14.3.3.2 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

vehicle  iterator  reset 

Sec.  2.9.3.1.1 

deferred  fnci 

Sec.  2.2.1 .1.1 

Table  2.4-150:  sbx_connection_synch_received  CSU  [8.4.3.2.13] 


2.4.3.2.14  sbx_connection_disconnect  CSU 

This  CSU  cancels  any  deferred  functions  associated  with  connection  and  disconnects  the 
buf_RUDP  layer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 
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_ _ Calls _ 

Function _ Where  Described _ 

cancel  fnci _ Sec.  2.2.1. 1.4 _ 

but  rudp_  disconnect  Sec.  2.4.2.5.9 

Table  2.4>151:  sbx  connection  disconnect  CSU  [8.4.3.2.14] 


2.4.3.2.15  sbx  connection  write  buffer  CSU 


This  CSU  enqueues  a  message  <mi  the  input  queue  of  the  associated  buf_RUDP  layer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

bufp 

pointer  to  OPFOR  HEADER 

Sec.  2.4. 1.1 

Errors 

Error  Name 

Reason  for  Error 

connection  in  unknown  state 

SBX  connection  is  neither  open,  nor  closed,  nor  loaded. 

Calls 

Function 

Where  Described 

buffer  enqueue 

Sec.  2.14.4.2.18 

ERROR  OUT 

Sec.  2.S.2.2 

Table  2.4*152:  sbx  connection  write  buffer  CSU  [8.4.3.2.15] 


2.4.3.2.16  sbx  connection  overloaded  CSU 


This  CSU  returns  information  about  whether  or  not  a  connection  is  overloaded.  A 
connection  is  overloaded  if  there  is  a  large  backup  of  messages  to  be  sent  or  a  large  backup 
of  sent  messages  waiting  for  acknowledgements. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2. 4.3 .3 

I  ReturnValues  I 

Return  Value 

Type 

Meanina 

TRUE 

int 

Input  queue  or  retransmit 
queue  is  filled  to  the  warning 
point. 

FALSE 

int 

No  overload. 
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1  Calls  1 

Function 

Where  Described 

queue  lenqth 

Sec.  2.14.4.2.2 

Table  2.4>153:  sbx  connection  overloaded  CSU  [8.4.3.2.16] 


2.4.3.2.17  sbx_connection_tick  CSU 

This  CSU  reads  messages  from  the  buf_RUDP  layer  and  causes  the  messages  to  be 
processed. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

Calls 

Function 

Where  Described 

but  rudp  read  message 

Sec.  2.4.2.5.11 

sbx_connection_synch_ 

received 

Sec.  2.4.3.2.13 

sbx_connection_process_ 

messages 

Sec.  2.4.3.2.27 

buf  rudp  tick 

Sec.  2.4.2.5.13 

Table  2.4-154:  sbx  connection  tick  CSU  [8.4.3.2.17] 


2.4.3.2.18  fill_sbx_opfor_header  CSU 

This  CSU  fills  out  the  header  information  for  an  outgoing  packet. 


1  Parameters  1 

■  Parameters 

Where  Typedef  Declared 

pointer  to  OPFOR  HEADER 

Sec.  2.4.1. 1 

Liti _ 

unsigned  int 

Standard 

int 

Standard 

Table  2.4-155:  fill_sbx_opfor_header  CSU  [8.4.3.2.18] 


2.4.3.2.19  sbx_connection_send_to_port  CSU 

This  CSU  sends  a  message  to  the  connection  associated  with  the  specified  port 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

port  number 

int 

Standard 

bufp 

pointer  to  OPFOR  HEADER 

Sec.  2.4.1. 1 
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1  Calls  1 

Function 

Where  Described 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

qet  sbx  from  port 

Sec.  2.4.3.2.5 

Table  2.4>156:  sbx_connection_send_to_port  CSU  [8.4.3.2.19] 


2.4.3.2.20  sbx_connectioii_process_vehicle_iinpact  CSU 

This  CSU  sends  a  vehicle  impact  message  to  a  connection  if  the  connection  has  been 
previously  informed  of  the  attacker  and  target  vehicles. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

spdu 

pointer  to  SimulationPDU 

p  sim.h 

Calls 

Function 

Where  Described 

saf  id  from  simnet  id 

extract  bit 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-157:  sbx_connection_process_vehicle_inipact  CSU  [8.4.3.2.20] 


2.4.3.2.21  sbx_connection_process_ground_impact  CSU 


This  CSU  sends  a  ground  impact  message  to  a  connection. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

spdu 

pointer  to  SimulationPDU 

p  sim.h 
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1  Calls  1 

Function 

Where  Described 

saf  id  from  simnet  id 

extract  bit 

buffer  aliocate 

Sec.  2.14.4.2.12 

fill  sbx  oDfor  header 

Sec.  2.4.3.2.18 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4*158:  sbx_connection_process_ground_iinpact  CSU  [8.4.3.2.21] 


2.4.3.2.22  sbx_connection_process_indirect_fire  CSU 
This  CSU  sends  an  indirect  fire  message  to  a  connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

spdu 

pointer  to  SimulationPDU 

p  sim.h 

Calls 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4*159:  sbx_connection_process_indirect_rire  CSU  [8.4.3.2.22] 


2.4.3.2.23  indirect_fire_to_sbx  CSU 

This  CSU  calls  sbx_connection_process_indirect_fire  for  each  connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

spdu 

pointer  to  SimulationPDU 

p sim.h 

Calls 

Function 

Where  Described 

sbx_connection_process_ 
indirect  fire 

Sec.  2.4.3.2.22 

Table  2.4*160:  indirect_flre_to_sbx  CSU  [8.4.3.2.23] 
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2.4.3.2.24  ground_impact_to_sbx  CSU 

This  CSU  calls  sbx_connection_process_ground_impact  fw  each  connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

spdu 

pointer  to  SimulationPDU 

p  sim.h 

Calls 

Function 

Where  Described 

sbx_connectionj5rocess_ 
around  impact 

Sec.  2.4.3.2.21 

Table  2.4>161:  ground_ifnpact_to_sbx  CSU  [8.4.3.2.24] 


2.4.3.2.25  vehicle_impact_to_sbx  CSU 

This  CSU  calls  sbx_connection_process_vehicle_impact  for  each  connection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

spdu 

pointer  to  SimulationPDU 

p  sim.h 

Calls 

Function 

Where  Described 

sbx_connectio  n jprocess_ 
vehicle  impact 

Sec.  2.4.3.2.20 

Table  2.4>162:  vehicle_impact_to_sbx  CSU  [8.4.3.2.25] 


2.4.3.2.26  sbx_connection_process_message  CSU 

This  CSU,  dependent  on  the  message  type,  calls  the  appropriate  handler  to  process  that 
particular  message  type. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msgjjtr 

pointer  to 

OPFOR  GENERIC  MSG 

Sec.  2.4.1. 1 

1  ReturnVaiues  1 

Return  Value 

Type 

sizeoK...) 

int 

Size  of  the  message  in  bytes.  I 
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Error  Name 


Received  obsolete 

CONTINUE_MISSION 

messaoe 


Unknown  messaoe  t 


Errors 


Reason  for  Error 


msQLtype  was  set  to  the  obsolete  value 
OPFOR  MSG  CONTINUE  MISSION 


was  set  to  an  unknown  value 


Function 


rint  oofor  header 


sbx_connection_create_unit_ 

mso 


sbx  connection  reset  ms 


sbx_connection_vehicle_ 

remit 


sbx_connection_service_ 
II  mso 


sbx  connection  disconnect 


sbx_connection_query_sub_ 

state 


sbx_connection_setJvis_ 
xmit  modes 


sbx_connection_setJvis_ 

arameters 


ERROR  OUT 


sbx  add  point 


sbx  add  area 


sbx  add  zone 


sbx  add  line 


sbx  add  route 


sbx  halt 


sbx  chanoe  speed 


sbx  chance  formation 


sbx  delete  cm 


sbx  follow  vehicle 


sbx  ooto  point 


sbx  resume  mission 


sbx  face  direction 


sbx_set_targeti  ng_ 
rameters 


sbx  attach  stealth 


sbx  rejoin  unit 


sbx  simulator  in  command 


Calls 


Where  Described 


Sec.  2.4.3.2.76 


Sec.  2.4.3.2.29 


Sec.  2.4.3.2.30 


Sec.  2.4.3.2.37 


Sec.  2.4.3.2.32 


Sec.  2.4.3.2.33 


Sec.  2.4.3.2.14 


Sec.  2.4.3.2.38 


Sec.  2.4.3.2.39 


Sec.  2.4.3.2.40 


Sec.  2. 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


Sec.  2 


.5.2.2 


.4.3.2.45 


.4.3.2.46 


.4.3.2.47 


.4.3.2.48 


.4.3.2.49 


.4.3.2.50 


.4.3.2.51 


.4.3.2.52 


.4.3.2.53 


.4.3.2.54 


.4.3.2.55 


.4.3.2.57 


.4.3.2.59 


.4.3.2.60 


.4.3.2.61 


.4.3.2.62 


Sec.  2.4.3.2.70 


Sec.  2.4.3.2.56 


Sec.  2.4.3.2.58 


Sec.  2.4.3.2.71 


Table  2.4-163  continued  on  the  foibwing  page 
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Function 

Where  Described 

sbx  land 

Sec.  2.4.3.2.63 

sbx  altitude 

Sec.  2.4.3.2.65 

sbx  hold 

Sec.  2.4.3.2.67 

sbx  attack 

Sec.  2.4.3.2.69 

Table  2.4>163:  sbx_connection_process_message  CSU  [8.4.3.2.26] 


2.4.3.2.27  sbx_connection_process_messages  CSU 

This  CSU  processes  all  messages  through  multiple  calls  to 
sbx_connection_process_message. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  char 

Standard 

Imsa  len 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

sbx_connection _process_ 
message 

Sec.  2.4.3.2.26 

Table  2.4-164:  sbx_connection_process_messages  CSU  [8.4.3.2.27] 


2.4.3.2.28  country_to_string  CSU 

This  CSU  returns  a  human  readable  string  identifying  a  country  code. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

c 

unsigned  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

"Other" 

char 

Country  is  not  USA  or  USSR 

"USA" 

char 

Country  is  USA 

"USSR" 

char 

Country  is  USSR 

"unknown" 

char 

Country  is  unknown 

Table  2.4-165:  country _to_string  CSU  [8.4.3.2.28] 
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2.4.3.2.29  sbx_connection_create_unit_msg  CSU 

This  CSU  processes  a  create  unit  message  and  causes  the  specified  unit  to  be  created. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx.connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  CREATE  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

map_echelon_number_to_ 
echelon  symbol 

Sec.  2.4.3.1.4 

map_echelon_type_number_ 
to  echelon  type  symbol 

Sec.  2.4.3.1.6 

forcelD  to  strino 

Sec.  2.9.2.1.3 

country  to  string 

Sec.  2.4.3.2.28 

print  messaoe  position 

Sec.  2.4.3.2.77 

create  unit 

Sec.  2.11.1.2 

get  symbol 

Sec.  2.1 .1.3.2 

Table  2.4-166:  sbx_connection_create_unit_msg  CSU  [8.4.3.2.29] 


2.4.3.2.30  sbx_connection_reset_msg  CSU 

This  CSU  processes  a  reset  message  and  removes  the  specified  vehicles.  Outstanding 
deferred  functions  are  canceled,  overlays  associated  with  the  connection  are  removed  and  a 
deferred  function,  to  inform  the  connection  what  units  are  left,  is  set  up. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  RESET  MSG 

Sec.  2.4.1. 1 

1  Errors  I 

Error  Name 

Reason  for  Error 

SBX  CONN  in  unknown  state 

SBX  connection  is  neither  open,  nor  closed,  nor  loaded. 

Table  2.4-167:  sbx_connection_reset_msg  CSU  [8.4.3.2.30] 


2.4.3.2.31  sbx_connection_generate_reset_vehicle  CSU 

This  CSU  generates  a  reset  message  for  a  vehicle  and  processes  this  message.  This 
function  is  called  when  remote  vehicles  are  deactivated  or  timed-out  from  the  battlefield. 


1 
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1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

vehicle 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

sbx_  connection,  reset  _  msa 

Sec.  2.4.3.2.30 

Table  2.4-168:  sbx_connection_generate_reset_vehicle  CSU  [8.4.3.2.31] 


2.4.3.2.32  sbx  connection  vehicle  reinit  CSU 


This  CSU  processes  a  vehicle  reinitialize  message  and  causes  a  vehicle's  position,  bearing, 
fuel  and  ammunition  to  be  initialized  to  specified  values. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg_ptr 

pointer  to 

VEHICLE  REINIT  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3  2 

sat  vehicle  reinit 

Sec.  2.6.1.1.17 

Table  2.4-169:  sbx  connection  vehicle  reinit  CSU  [8.4.3.2.32] 


2.4.3.2.33  sbx_connection_service_poll_nisg  CSU 

This  CSU  processes  a  POLL_MSG.  Three  types  of  poll  views  are  supported.  In 
GODS_EYE_VIEW,  all  vehicles  are  reported.  In  COMMANDERS_EYE_VIEW,  all 
vehicles  known  to  vehicles  created  on  ^e  workstation  are  reported.  In 
NON_GODS_EYE_VIEW,  all  vehicles  known  by  a  unit  are  reported.  A  deferred  function 
IS  set  to  begin  sending  the  position  messages  for  die  desired  vehicles. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  POLL  MSG 

Sec.  2.4.1. 1 
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_ Errors _ 

Error  Name _ Reason  for  Error  _ 

Unknown  poll  request  Neither  G0DS_EVE_VIEW,  nor  COMMANDERS_EYE_ 

VIEW,  nor  NON GQDS EYE VIEW  was  requested. 


_ _ Calls _ 

Function _ Where  Described _ 

sbx  connection  wat  pulse  Sec.  2.4.3.2.34 _ 

DEBUG  CONNECTION  Sec.  2.4.2  4  See  Appendix  A _ 

poll  request  to  string _ Sec.  2.4.3.2.6 _ 

sbx  set  all  known  vehicles  Sec.  2.4.3.2.42 _ 

sbx_set_topJevel_known_v  Sec.  2.4.3.2.44 

ehicles _ 

sbx_set_specific_known_veh  Sec.  2.4.3.2.43 

ides _ 

ERROR  OUT _  Sec.  2.5.2.2 _ 

deferred  tnci  Sec.  2. 2. 1.1.1 

Table  2.4-170:  sbx_connection_service_poII_msg  CSU  [8.4.3.2.33] 


2.4.3.2.34  sbx_connection_wat_pulse  CSL) 


This  CSU  sends  position  messages  for  the  desired  vehicles. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvpedef  Declared 

sbx.connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

wat _ptr 

pointer  to 

VEHICLE  POSITION  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

sbx  connection  overloaded 

Sec.  2.4.3.2.16 

deferred  fnci 

Sec.  2.2.1. 1.1 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

extract  bit 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

fill  in  position  data 

Sec.  2.14.1.1.3 

saf  vehicle  checkpoint  state 

Sec.  2.6.1.1.16 

buf  rudp  tick 

Sec.  2.4.2.5.13 

buf_rudp  flush 

Sec.  2.4.2.5.10 

Table  2.4-171;  sbx_connection_wat_pulse  CSU  [8.4.3.2.34] 
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2.4.3.2.35  sbx_connection_stat_pulse  CSU 
This  CSU  sends  PAE  messages  for  all  the  vehicles. 


1  Parameters  1 

Parameters 

Typo 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

vs _ptr 

pointer  to 

VEHICLE  PAE  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

sbx  connection  overloaded 

Sec.  2.4.3.2.16 

deferred  fnci 

Sec.  2.2.1 .1.1 

sbx  connection  write  buffer 

Sec.  2.4.3.2.15 

buffer  deallocate 

Sec.  2.14.4.2.15 

vehicle  iterator  once  next 

Sec.  2.9.3. 1.3 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

OBJ  VEHICLEID 

Sec.  2.9.1. 1 

fill  in  position  data 

Sec.  2.14.1.1.3 

fill  in  appearance  data 

Sec.  2.14.1.1.1 

fill  in  echelon  data 

Sec.  2  14.1.1.2 

Table  2.4-172:  sbx_connection_stat_pulse  CSU  [8.4.3.2.35] 


2.4.3.2.36  arty_type_string  CSU 

This  CSU  returns  a  human-readable  string  conesponding  to  an  artillery  type. 


1  Parameters  I 

1  Parameters  1 

Type 

Where  Typedef  Declared 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meanina 

"ARTY  TYPE  GROUND" 

char 

Ground  artillery 

"ARTY  TYPE  VEHICLE" 

char 

Vehicle  artillery 

"ARTY  TYPE  DEATH" 

char 

Death  artillery 

"UNKNOWN" 

char 

Unknown  artillery 

Table  2.4-173:  arty_type_string  CSU  [8.4.3.2.36] 
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2.4.3.2.37  sbx_connection_generate_arty_msg  CSU 

This  CSU  processes  an  artillery  message  and  causes  artillery  blasts  to  be  generated. 


1  Parameters  1 

1  Parameters  1 

Type 

Where  Typedef  Declared 

pointer  to  ARTY  MSG 

Sec.  2.4.1. 1 

1  Errors  1 

Error  Name 

Reason  for  Error 

Cam  kill  nonexistant  vehicle 

Victim  does  not  exist 

1  Calls  1 

Function 

Where  Described 

arty  type  strinq 

Sec.  2.4.3.2.36 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

ERROR  OUT 

Sec.  2.5.2.2 

vehicle  kill 

Sec.  2.3.1. 2 

generate  indirect  fire  pkt 

Sec.  2.3.1. 4 

Table  2.4-174:  sbx_connection_generate_arty_msg  CSU  [8.4.3.2.37] 


2.4.3.2.38  sbx_connection_query_sub_state  CSU 

This  CSU  processes  a  query  substate  message  requesting  more  information  about  a  vehicle 
or  composite,  and  causes  a  report  to  be  sent  out  by  a  unit. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg_ptr 

pointer  to 

QUERY  SUB  STATE  MSG 

Sec.  2. 4. 1.1 

Errors 

Error  Name 

Reason  for  Error 

No  vehicle ....  Message 
QUERY  SUB  STATE 

Vehicle  id  unknown 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

generate  status  report 

Sec.  2.14.1.1.11 

ERROR  OUT 

Sec.  2.5.2.2 

Table  2.4-175:  sbx_connection_query_sub_state  CSU  [8.4.3.2.38] 
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2.4.3.2.39  sbx_connection_set_ivls_xiiiit_modes  CSU 

This  CSU  processes  the  IVIS  transmit  modes  message  indicating  whether  FVIS  packets  are 
transmitted  to  SIMNET  and  whether  FVIS  reports  are  sent  to  the  Symbolics,  and  adjusts  the 
IVIS  transmit  modes. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

msQLptr 

piinter  to 

IMS  XMIT  MODES  MSG 

Sec.  2.4.1. 1 

Errors 

Error  Name 

Reason  for  Error 

No  vehicle ....  Message 

SET  IVIS  MODES. 

Vehicle  id  unknown 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

ERROR  OUT 

Sec.  2.5.2  2 

Table  2.4-176:  sbx_connection_set  ivis  xmit  mode  CSU  [8.4.3.2.39] 


2.4.3.2.40  sbx_connection_set_lvis_parameters  CSU 

This  CSU  processes  the  IVIS  parameters  message  allowing  an  operator  at  the  workstation 
to  change  key  parameters  for  certain  IVIS  reports,  and  adjusts  the  IVIS  parameters. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

msg  ptr 

pointer  to 

IVIS  PARAMETERS  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

square 

Sim  macros.h 

Table  2.4-177:  sbx_connection_set_ivis_parameters  CSU  [8.4.3.2.40] 


2.4.3.2.41  sbx_swap_known_vehicles  CSU 
This  CSU  saves  what  vehicles  are  known  to  a  workstation. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

Table  2.4-178:  sbx_swap  known  vehicles  CSU  [8.4.3.2.41] 
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2.4.3.2.42  sbx_set_alI_known_vehicles  CSU 

This  CSU  creates  a  connection  so  that  it  is  aware  of  about  all  the  vehicles  on  the  battlefield. 


Parameters 


sbx  connection 


Parameters 


pointer  to 

SBX  CONNECTION  VARS 


Where  Tvoedef  Declared 


Sec.  2.4.3.3 


Function 


set  bitfield 


Calls 


Where  Described 


Sec.  2.14.3.4.7 


Table  2.4-179:  sbx_set_all_known_vehicIes  CSU  [8.4.3.2.42] 


2.4.3.2.43  sbx_set_specific_known_vehicles  CSU 

This  CSU  creates  a  connection  so  that  it  is  aware  of  only  the  units  that  a  specified  unit  can 
see. 


Parameters 


id 


sbx  connection 


Parameters 


unsioned  int 


pointer  to 

SBX  CONNECTION VARS 


Where  Typedef  Declared 


Standard 


Sec.  2.4.3.3 


Function 


sbx  swap  known  vehicles 


clear  bitfield 


LOOKUP  VEHICLE 


LOOKUP  FORCEID 


is  enem 


set  bit 


or  bitfield 


Calls 


Where  Described 


Sec.  2.4.3.2.41 


Sec.  2.14.3.4.6 


Sec.  2.9.3.2 


Sec.  2.9.1. 1 


Sec.  2.13.3.1 


Sec.  2.14.3.4.3 


Sec.  2.14.3.4.8 


Table  2.4-180:  sbx_set_specific_known_vehicles  CSU  [8.4.3.2.43] 

2.4.3.2.44  sbx_set_topJevel_known_vehicles  CSU 

This  CSU  creates  a  connection  so  that  it  is  aware  of  only  the  vehicles  that  its  units  can  see. 
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1  Calls  1 

Function 

Where  Described 

sbx  swap  known  vehicles 

Sec.  2.4.3.2.41 

set  bitfield 

Sec.  2.4.3.4.7 

clear  bitfield 

Sec.  2.14.3.4.6 

LCX)KUP  VEHICLE 

Sec.  2.9.3.2 

is  enemy 

Sec.  2.13.3.1 

LOOKUP  FORCEID 

Sec.  2.9.1. 1 

set  bit 

Sec.  2.14.3.4.3 

or  bitfield 

Sec.  2.14.3.4.8 

Table  2.4-181:  sbx_set_top_Ievel_known_vehicles  CSU  [8.4.3.2.44] 


2.4.3.2.45  sbx_add_point  CSU 

This  CSU  processes  a  point  message,  causing  a  new  point  to  be  added  to  an  overlay,  or 
modifies  an  existing  point. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  POINT  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

cm  add  ooint 

Sec.  2.10.2.1.8 

Table  2.4-182:  sbx_add_point  CSU  [8.4.3.2.45] 


2.4.3.2.46  sbx_add^area  CSU 

This  CSU  processes  an  area  message,  causing  a  new  area  to  be  added  to  an  overlay,  or 
modifies  an  existing  area. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3  3 

pointer  to  AREA  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

cm_add  area 

Sec.  2.10.2.1.9 

Table  2.4-183:  sbx  add  area  CSU  [8.4.3.2.46] 
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2.4.3.2.47  sbx  add  zone  CSU 


This  CSU  processes  a  zone  message,  cauing  a  new  zone  to  be  added  to  an  overlay,  or 
modiHes  an  existing  zone. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msa  Ptr 

pointer  to  ZONE  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

cm  add  zone 

Sec.  2.10.2.1.10 

Table  2.4*184:  sbx  add  zone  CSU  [8.4.3.2.47] 


2.4.3.2.48  sbx  add  line  CSU 


This  CSU  processes  a  line  message,  causing  a  new  line  to  be  added  to  an  overlay,  or 
modifies  an  existing  line. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  LINE  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

cm  add  line 

Sec.  2.10.2.1.11 

Table  2.4*185:  sbx  add  line  CSU  [8.4.3.2.48] 


2.4.3.2.49  sbx  add  route  CSU 


This  CSU  processes  a  route  message,  causing  a  new  route  to  be  added  to  an  overlay,  or 
modifies  an  existing  route. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  ROUTE  MSG 

Sec.  2. 4. 1.1 

1  Calls  1 

Function 

Where  Described 

cm  add  route 

Sec.  2.10.2.1.12 

Table  2.4*186:  sbx  add  route  CSU  [8.4.3.2.49] 
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2.4.3.2.50  sbx_deIete_overlay  CSU 

This  CSU  processes  a  delete  overlay  message,  causing  an  overlay  to  be  deleted. 


Parameters 


sbx 


msjLptr 


Parameters 


pointer  to 

SBX  CONNECTION  VARS 


pointer  to 

DELETE  OVERLAY  MSG 


Where  Tvoedef  Declared 


Sec.  2.4.3.3 


Sec.  2.4.1. 1 


Function 


fssmsmEsm 


Calls 


Where  Described 


Sec.  2.10.2.1.13 


Table  2.4-187:  sbx_delete_overlay  CSU  [8.4.3.2.50] 


2.4.3.2.51  sbx_execute_overlay  CSU 

This  CSU  processes  an  execute  overlay  message,  causing  a  unit  to  follow  the  indicated 
route  and  obey  the  control  measures  in  the  spewed  overlay. 


Parameters 


sbx 


msg  ptr 


Parameters 


e 


pointer  to 

SBX  CONNECTION  VARS 


1 


Where  Typedef  Declared 


Sec.  2.4.3.3 


Sec.  2.4.1. 1 


EXECUTE  OVERLAY  MSG 


Function 


Esmsmscmm 


Calls 


Where  Described 


Sec.  2.10.2.1.20 


Table  2.4-188:  sbx_execute_overIay  CSU  [8.4.3.2.51] 


2.4,3.2.52  sbx  halt  CSU 

This  CSU  processes  a  halt  message,  causing  a  vehicle  or  unit  to  halt. 
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1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.g.3.2 

saf  vehicle  halt 

Sec.  2.6.1.1.52 

composite  halt 

Sec.  2.8.1.3.43 

Table  2.4-189:  sbx  halt  CSU  [8.4.3.2.52] 


2.4.3.2.53  sbx_change_speed  CSU 

This  CSU  processes  a  change  speed  message,  causing  a  vehicle  or  unit  to  change  speed. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg_ptr 

pointer  to 

CHANGE  SPEED  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

saf  vehicle  chanoe  speed 

Sec.  2.6.1.1.53 

composite  chanoe  speed 

Sec.  2.8.1.3.44 

Table  2.4-190:  sbx_change_speed  CSU  [8.4.3.2.53] 


2.4.3.2.54  sbx_change_formation  CSU 


This  CSU  processes  a  change  formation  message,  causing  a  change  in  formation. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg  ptr 

pointer  to 

CHANGE  FORMATION  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3  2 

composite  change  formation 

Sec.  2.8.1.3.47 

Table  2.4-191:  sbx_change_forniation  CSU  [8.4.3.2.54] 
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2.4.3.2.55  sbx_delete_cin  CSU 

Hiis  CSU  processes  a  delete  control  measure  message,  causing  a  control  measure  to  be 
deletnl  from  an  overlay. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  DELETE  CM  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

cm  delete  cm 

Sec.  2.10.2.1.14 

Table  2.4-192:  sbx  delete  cm  CSU  [8.4.3.2.55] 


2.4.3.2.56  sbx_rejoin_unit  CSU 


This  CSU  processes  a  rejoin  unit  message,  causing  a  vehicle  or  unit  to  abandon  its  current 
mission,  as  assigned  by  an  execute  overlay  message,  and  rejoin  its  superior  unit  (if  a 
superior  unit  exists). 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msgjstr 

pointer  to 

REJOIN  UNIT  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

sat  vehicle  rejoin  unit 

Sec.  2.6.1  1.45 

composite  rejoin  unit 

Sec.  2.8.-' .3.39 

Table  2.4-193:  sbx_rejoin_unit  CSU  [8.4.3.2.56] 


2.4.3.2.57  sbx_folIow_vehicle  CSU 

This  CSU  processes  a  follow  vehicle  message,  causing  a  vehicle  or  unit  to  follow  a 
vehicle. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msgjJtr 

pointer  to 

FOLLOW  VEHICLE  MSG 

Sec.  2.4.1. 1 
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1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

saf  vehicle  follow  vehicle 

Sec.  2.6.1.1.54 

composite  follow  vehicle 

Sec.  2.8.1.3.45 

Table  2.4-194:  sbx_follow_vehicle  CSU  [8.4.3.2.57] 


2.4.3.2.58  sbx_simulator_in_command  CSU 

This  CSU  processes  a  simulator  in  command  message,  causing  the  leading  vehicle  of  a  unit 
to  be  deactivated.  The  rest  of  the  unit  then  follows  the  specific  vehicle,  which  must  be  a 
remote  vehicle. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3  3 

msg  ptr 

pointer  to  SIMULATOR  IN 
COMMAND  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9.1. 1 

Sbx  printf 

Sec.  2.4.3.2.8 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

composite_simulatorJn_ 

command 

Sec.  2.8.1.3.46 

Table  2.4-195:  sbx_simulator  in  command  CSU  [8.4.3.2.58] 


2.4.3.2.59  sbx_goto_point  CSU 

This  CSU  processes  a  go  to  point  message,  causing  a  unit  or  vehicle  to  go  to  a  specified 
point. 


Parameters 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg  ptr 

pointer  to 

GOTO  POINT  MSG 

Sec.  2.4.1. 1 
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1  Calls  1 

Function 

Where  Described 

strina  for  hold  type 

Sec.  2.4.3.2.66 

LOOKUP  VEHICLE 

Sec.  2.9.3  2 

saf  vehicle  aoto  point 

Sec.  2.6.1.1.55 

composite  aoto  point 

Sec.  2.8.1.3.48 

Table  2.4-196:  sbx_goto_point  CSU  [8.4.3.2.59] 


2.4.3.2.60  sbx  resume  mission  CSU 


This  CSU  processes  a  resume  mission  message,  causing  a  unit  ot  vehicle  to  return  to  the 
current  mission  after  being  interrupted  by  an  immediate  intervention. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg  ptr 

pointer  to 

RESUME  MISSION  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2  9.3.2 

saf  vehicle  resume  mission 

Sec.  2.6.1.1.56 

composite  resume  mission 

Sec.  2.8.1.3.49 

Table  2.4-197:  sbx  resume  mission  CSU  [8.4.3.2.60] 


2.4.3.2.61  sbx_face_direction  CSU 

This  CSU  processes  a  face  direction  message,  causing  a  unit  or  vehicle  to  face  a  specified 
direction. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2  4.3.3 

msg_ptr 

pointer  to 

FACE  DIRECTION  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

saf  vehicle  face  direction 

Sec.  2.6.1.1.57 

composite  face,  direction 

Sec.  2.8.1.3.50 

Table  2.4-198:  sbxjace  direction  CSU  [8.4.3.2.61] 


l?x 


BBN  Systems  and  Technologies _ SAP  Simularion  Host  CSCI 

2.4.3.2.62  sbx_set_targeting_parameters  CSU 


This  CSU  processes  a  set  targeting  message,  causing  the  targeting  parameters  to  be  set. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg_ptr 

pointer  to 

SET  TARGETING  MSG 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

firestatus  to  string 

Sec.  2.6.9.3  4 

set  tarqetina  parameters 

Sec.  2.14.1.1.7 

Table  2.4-199:  sbx_set_targeting_parameters  CSU  [8.4.3.2.62] 


2.4.3.2.63  sbxjand  CSU 

This  CSU  processes  a  land  message,  causing  an  air-unit  or  vehicle  to  land. 


Parameters 


Parameters 


sbx 


pointer  to 

SBX  CONNECTION  VARS 


inter  to  LAND  MSG 


Where  Typedef  Declared 


Sec.  2.4.3.3 


Sec.  2.4.1. 1 


Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3  2 

composite  land 

Sec.  2.8.1.3.52 

pilot  land  im 

Sec.  2.6.4.2.70 

Table  2.4-200:  sbxjand  CSU  [8.4.3.2.63] 


2.4.3.2.64  string_for_altitudeJype  CSU 

This  CSU  returns  a  human-readable  string  identifying  an  altitude  type. 


Where  Typedef  Declared 
Standard 


Meaning _ 

Absolute  altitude _ 

Altitude  above  ground  level 
Unknown  altitude  type 


Table  2.4-201:  string_for_altitudeJype  CSU  [8.4.3.2.64] 
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2.4.3.2.65  sbx_aUitude  CSU 

This  CSU  processes  an  altitude  message,  causing  an  air-unit  or  vehicle  to  change  altitude. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  ALTITUDE  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

strina  for  altitude  type 

Sec.  2.4.3.2.64 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

composite  chance  altitude 

Sec.  2.8.1.3.53 

pilot  chanae  altitude  im 

Sec.  2.6.4.2.66 

Table  2.4-202:  sbx_aUitude  CSU  [8.4.3.2.65] 

2.4.3.2.66  string_for_hold_type  CSU 

This  CSU  returns  a  human-readable  string  identifying  a  hold  type. 


1  Parameters  1 

■  Parameters 

Type 

Where  Typedef  Declared 

int 

Standard 

1  ReturnVatues  1 

Return  Value 

Type 

"hover" 

char 

Hover  hold 

"orbit" 

char 

Orbit  hold 

"race  track" 

char 

Race  track  hold 

"unknown  type" 

char 

Unknown  hold  type 

Table  2.4-203;  string_for_hold_type  CSU  [8.4.3.2.66] 


2.4.3.2.67  sbx  hold  CSU 


This  CSU  processes  a  hold  message,  causing  an  air-unit  or  vehicle  to  hold. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3  3 

pointer  to  HOLD  MSG 

Sec.  2.4.1. 1 
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1  Calls  1 

Function 

Where  Described 

strinq  for  hold  type 

Sec.  2.4.3.2.66 

LOOKUP  VEHICLE 

Sec.  2.9.3  2 

composite  halt 

Sec.  2.8.1.3.43 

pilot  hold  im 

Sec.  2.6.4.2.76 

Table  2.4-204:  sbx  hold  CSU  [8.4.3.2.67] 


2.4.3.2.68  string_for_attack_type  CSU 

This  CSU  returns  a  human-readable  string  identifying  an  attack  type. 


1  Parameters  1 

[Parameters  1 

Type 

Where  Typedef  Declared 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meanlnq 

"runninq  fire  attack’ 

char 

Runninq  fire  attack 

char 

Popup  attack 

1  ’unknown  type’ 

char 

Unknown  attack  type 

Table  2.4-205;  string_for_attack_type  CSU  [8.4.3.2.68] 


2.4.3.2.69  sbx_attack  CSU 

This  CSU  processes  an  attack  message,  causing  an  air-unit  or  vehicle  to  attack. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  ATTACK  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

strinq  for  attack  type 

Sec.  2.4.3.2.68 

LOOKUP  VEHICLE 

Sec.  2.9  3.2 

composite  attack 

Sec.  2.8.1.3.51 

pilot  hoverattack  im 

Sec.  2.6.4.2.75 

Table  2.4-206:  sbx  attack  CSU  [8.4.3.2.69] 


131 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2.4.3.2.70  sbx_attach_steaUh  CSU 

This  CSU  handles  an  attach  stealth  message,  causing  a  stealth  to  attach  to  a  unit  or  vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

msg  ptr 

pointer  to 

ATTACH  STEALTH  MSG 

Sec.  2.4. 1.1 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

SAF  COMPOSITE  P 

composite_find_vehicle_for_ 

stealth 

Sec.  2.8.1.3.29 

FOR  VEHICLES  DO 

Sec.  2.9  3.2 

simnet  id  from  saf  id 

vec  COPY 

Sec.  2.14.3.5.17 

OBJ  POSITION 

Sec.  2.9.1. 1 

stealth  send  teleport  to 

stealth_send_attach_to_ 

vehicle 

OBJ  VEHICLEID 

Sec.  2.9. 1.1 

remote_change_stealth_ 

controllinq  port 

Sec.  2.7.1.16 

Table  2.4*207:  sbx  attach  stealth  CSU  [8.4.3.2.70] 


2.4.3.2.71  sbx_resupply  CSU 

This  CSU  processes  a  resupply  message,  causing  a  vehicle  to  resupply  from  a  resupply 
vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

sbx 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

pointer  to  RESUPPLY  MSG 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9  3.2 

Start  resupply  of  to 

Sec.  2.6  6.1. 4 

Table  2.4-208:  sbx_resuppl.v  CSU  [8.4.3.2.71] 
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2.4.3.2.72 


broadcast  echelon  data  CSU 


This  CSU  causes  a  unit  to  send  an  echelon  packet  to  all  connections. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

on  whom 

unsiqned  int 

Standard 

Errors 

Error  Name 

Reason  for  Error 

Cannot  send  status  of 
nonexistant  vehicle 

Vehicle  does  not  exist 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2  9.3.2 

ERROR  OUT 

Sec.  2.5.2.2 

buffer  allocate 

Sec.  2.14.4.1.10 

fill  in  echelon  data 

Sec.  2.14.1.1.2 

fill  sbx  ODfor  header 

Sec.  2.4.3.2.18 

write  buffer  all  sbx 

Sec.  2.4.3.2.3 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4*209:  broadcast  echelon  data  CSU  [8.4.3.2.72] 


2.4.3.2.73  broadcast_appearance_data  CSU 

This  CSU  causes  a  unit  to  send  an  app«arance  packet  to  all  connections. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

on  whom 

unsiqned  int 

Standard 

Errors 

Error  Name 

Reason  for  Error 

Cannot  send  status  of 
nonexistant  vehicle 

Vehicle  does  not  exist 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

ERROR  OUT 

Sec.  2.5  2.2 

buffer  allocate 

Sec.  2.14.4.1.10 

fill  in  aooearance  data 

Sec.  2.14.1.1.1 

fill  sbx  ODfor  header 

Sec.  2.4.3.2.18 

write  buffer  all  sbx 

Sec.  2.4.3.2  3 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-210:  broadcast_appearance_data  CSU  [8.4.3.2.73] 
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2.4.3.2.74  broadcast_pae_data  CSU 

This  CSU  causes  a  unit  to  send  a  PAE  packet  to  all  connections. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

on  whom 

unsianed  int 

Standard 

Errors 

Error  Name 

Reason  for  Error 

Cannot  send  status  of 
nonexistant  vehicle 

Vehicle  does  not  exist 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2 

ERROR  OUT 

Sec.  2.5.2.2 

buffer  allocate 

Sec.  2.14.4.1.10 

fill  in  Dosition  data 

Sec.  2.14.1.1.3 

fill  in  appearance  data 

Sec.  2.14.1.1.1 

fill  in  echelon  data 

Sec.  2.14.1.1.2 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

write  buffer  all  sbx 

Sec.  2.4.3.2.3 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-211: 


broadcast_pae_data 


CSU  [8.4.3.2.74] 


2.4.3.2.75  broadcast_veh_is_gone  CSU 


This  CSU  causes  a  unit  to  send  a  vehicle-is-gone  packet  to  all  connections. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

vehicle  id 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

write  buffer  all  sbx 

Sec.  2.4.3.2  3 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.4-212:  broadcast_veh_ls_gone  CSU  [8.4.3.2.75] 
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2.4.3.2.76  print_opfor_header  CSU 


This  CSU  prints  the  fields  in  an  opfor  header. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

hdr  ptr 

pointer  to  OPFOR  HEADER 

Sec.  2.4.1. 1 

Table  2.4-213:  print_opfor_header  CSU  [8.4.3.2.76] 


2.4.3.2.77  prmt_message_position  CSU 


This  CSU  prints  the  fields  in  a  vector. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

vec  ptr 

pointer  to  REAL 

sim-types.h 

Table  2.4-214:  print_message_position  CSU  [8.4.3.2.77] 


2.4.3.2.78  print_vehicle_ids  CSU 
This  CSU  prints  zero  or  more  vehicle  ids. 


1  Parameters  1 

Parameters 

wrrmmmmmmm 

Where  Tvpedef  Declared 

id  ptr 

pointer  to  unsianed  int 

Standard 

count 

int 

Standard 

Table  2.4-215:  print_vehiclejds  CSU  [8.4.3.2.78] 

2.4.3.2.79  sbx_connection_show_top_level_units  CSU 
This  CSU  causes  the  top  level  units  to  be  printed. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

sbx_connection 

pointer  to 

SBX  CONNECTION  VARS 

Sec.  2.4.3.3 

Table  2.4-216:  sbx_connectlon_show_top_level_units  CSU  [8.4.3.2.79] 
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2. 4. 3. 3  sbx.h  CSU 

/simnet/sIc^ost/sbx.h 

This  CSU  contains  the  structure  definition  (SBX_CONNECTION_VARS)  and  symbolic 
constants  used  by  the  workstation  communicaticm  code,  both  shown  below.  In  addition, 
the  file  contains  the  macro  definition  for  allocate_sbx_c(mnection  contained  in  Appendix  A. 


Item 

Tvoe 

Where  Type  Defined 

stat  iterator 

VEHICLE  ITERATOR 

Sec.  2.9.3.2 

s 

pointer  to 

BUF  RUDP  SOCKET 

Sec.  2.4.2.6 

wat  Dulse  event 

int 

Standard 

stat  Dulse  event 

int 

Standard 

wat  index 

int 

Standard 

Dort  number 

int 

Standard 

forcelO 

ForcelD 

basic.h 

both  forces 

int 

Standard 

num  tOD  level  units 

unsianed  short 

Standard 

tOD  level  units 

unsigned  int 

Standard 

vehicles  known  to  workstation 

Dointertochar 

Standard 

last  vehicles  known  to  workstation 

Dointertochar 

Standard 

last  Doll  mode 

int 

Standard 

overlays 

pointer  to 

OVERLAY  LIST 

Sec.  2.10.2.2 

stealth  address 

Simulation  Address 

address,  h 

Table  2.4-217;  SBX_CONNECTION_VARS  Structure  Definition 


Constant 

Value 

MAX  TOP  LEVEL  UNITS 

32 

MAX  SBX  CONNS 

16 

Table  2.4-218:  sbx.h  Symbolic  Constants 
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2.5  PARSER  INTERFACE  CSC 

The  parser  interface  code  handles  command  inputs  from  the  STDIN  device  of  the  UNIX 
process  which  is  running  the  simulation.  This  device  can  be  the  SAP  Simhost  HWCI 
console  (a  WYSE60  RS-232  terminal)  ot  a  remote  login  from  a  terminal  emulator  wi  sor 
other  machine  such  as  the  SAP  Workstation  HWCI. 


Parser 

Interface 


libparser 

CSC 


arser  Command 
Processor 


par_base.c 

CSC 

8.5. 1.1 


par_oonst.c 

CSC 

8.5. 1.2 


parser.c 

CSC 

8.5.2.1 


par_copy.c 

CSC 

8.5. 1.3 


par_edit.c 

CSC 

8.5. 1.4 


CSU  8.5.2.2 


par  fields.c 
CSC 


par  lib.c 
CSC 


8.5. 1.5 


8.5.1. 6 


par_util.c 

CSC 


par_hist.c 

CSC 


8.5. 1.7 


8.5. 1.8 


par_unix.c 

CSC 


r 

kludge.c 

CSU  8.5.1.10 

j 

8.5. 1.9 


libparser.h 
CSU  8.5.1.11 


Figure  2.5-1:  Parser  Interface  CSC  Structure 
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The  parser  commands  perform  system  operator  functions,  such  as  controlling  the  amount 
of  debugging  ouput  printed  at  the  STDIN  device,  and  inspecting  the  state  of  various 
simulation  objects,  network  statistics,  and  simulation  loa^ng.  >^en  ticked  by  the 
scheduler,  the  parser  code  processes  its  input  buffer  and  returns  output.  The  simulation  is 
stopped  by  an  exit  command  from  the  parser. 

2.5.1  libparser  CSC 

/simnet/libsrc^ibparser 


This  library  does  the  work  of  conversion  for  the  parser  inputs  code. 

2.5. 1.1  par_base.c  CSC 
/siinnet/libsrc/libparser^ar_base.c 


The  CSUs  in  this  CSC  are  those  parse  functions  that  have  special  knowledge;  therefore, 
they  can  not  be  added  like  user-addable  parse  functions. 


par_basd.c 

CSC 


8.5.1.1 


CParseInput 
CSU  8.S.1.1.1 


ParseUst 
CSU  8.5.1 .1.2 


1 


ParseKeyword  ^ 
CSU  8.5.1. 1.3 


c 


ParseCommandOone 
CSU  8.5.1. 1.4 


ParseDoKeywordTable  ^ 
CSU8.5.1.1.5  J 


Figure  2.5-2:  par_base.c  CSC  Structure 


2.5. 1.1.1  Parseinput  CSU 

This  function  executes  a  parse  table.  It  finds  the  end  of  the  table  and  calls  ParseList  to  do 
the  work.  It  then  processes  the  parse  value  returned  by  ParseList. 


I  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

table 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 
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Function 


BeainninaOfLine 


ParseUst 


RestoreCursor 


KillForward 


ClearUne 


EmotyLine 


ParseError 


EndOfLine 


BackChar 


NextChar 


InsertChar 


Free 


UodateLine 


RedisolavLine 


Where 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Sec.  2.5 


Calls 


Described 


.1.4.11 


.1.1.2 


.1.4.9 


.1.4.14 


.1.4.19 


.1.4.10 


.1.7.7 


.1.4.14 


.1.4.25 


.1.4.7 


.1.4.23 


.1.9.2 


.1.4.3 


.1.4.5 


Table  2.5-1:  Parseinput  CSU  [8.5.1.1.1] 


2.5. 1.1.2  ParseList  CSU 


This  CSU  searches  through  the  parse  table,  reading  the  table  token  by  token  and  executing 
all  parse  functions  associated  with  non-keyword  functionality  (e.g.,  loading  data). 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

argc 

int 

Standard 

first 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

last 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

PARSE  ERROR 

int 

Extra  data  on  line 

PARSE  SUCCESS 

int 

Successful  parse 

PARSE  IGNORE 

int 

Needs  completed  command 

val 

int 

Returned  new  value  due  to 
illegal  command  if  processing 
P_PARSE_FUNCTION  and 
val 

argc 

int 

new  value  due  to  illegal 
command 
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Errors 

Error  Name 

Reason  for  Error 

PARSE  ERROR 

Extra  data  on  line 

PARSE  IGNORE 

Command  incomplete 

val 

Returned  new  value  due  to  illegal  command  if  processing 

P  PARSE  FUNCTION  and  val 

Returned  new  value  due  to  jlleoal  command 


Function 


ParsePnnt 


ParseGetToken 


ParseEnor 


CommandLo 


ParseMessaae 


ParseFindEndList 


ParseKevword 


TyoeFields 


Calls 


Where  Described 


Sec.  2.5.1 .9.3 


Sec.  2.5.1 .7.6 


Sec.  2.5.1. 7.7 


Sec.  2.5. 1.8.1 


Sec.  2.5.1. 7.8 


Sec.  2.5. 1.7.9 


Sec.  2.5.1. 1.3 


Sec.  2.5.1. 5.2 


Table  2.5-2:  ParseList  CSU  [8.5.1. 1.2] 


2. 5. 1.1. 3  ParseKeyword  CSU 

This  CSU  processes  a  keyword  list  by  determining  the  next  keyword  and  processing  the 
commands  that  follow  it. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

arpc 

int 

Standard 

arqv 

pointer  to  char 

Standard 

first 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

end 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

ReturnValues 

Return  Value 

Type 

Meaning 

PARSE  NEEDKEYWORD 

int 

out  of  tokens 

PARSE  ERROR 

int 

error  has  occurred 

PARSE  IGNORE 

int 

ignore  status 

PARSE  UPDATE  LINE 

int 

update  line 

(ParseUstO) 

int 

new  values  of  argc 

argc 

int 

new  value  of  argc 

ERROR 

int 

error  occurred 
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1  Errors  1 

Error  Name 

Reason  for  Error 

PARSE  ERROR 

No  keyword  match 

PARSE  IGNORE 

Other  parse  table  token  error  ( ie.  not  unique  keyword! 

ERROR 

Internal  error  in  parser 

Calls 

Function 

Where  Described 

Parse  Print 

Sec.  2.5.1. 9.3 

ParseGetToken 

Sec.  2.5. 1.7.6 

ParseMatch 

Sec.  2.5.1.7.10 

ParseFindEndList 

Sec.  2.5.1 .7.9 

ParseError 

Sec.  2.5.1. 7.7 

Parse  EscapeComplete 

Sec.  2.5.1.7.12 

ParseList 

Sec.  2.5.1. 1.2 

Table  2.5-3:  ParseKeyword  CSU  [8.5.1.1.31 


2.5. 1.1.4  ParseCommandDone  CSU 
This  CSU  terminates  a  command  list 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

nu  arqc 

int 

Standard 

nu  aravf  1 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

1  ReturnValues  1 

Return  Value 

Meanina 

PARSE  ERROR 

int 

Extra  data  in  line 

PARSE  SUCCESS 

int 

Parse  successful 

PARSE  IGNORE 

int 

No  carriage  return  at  line  end 

1  Calls  1 

Function 

Where  Described 

ParseGetToken 

Sec.  2.5.1. 7.6 

ParseError 

Sec.  2.5.1,7  7 

ParseMessage 

Sec.  2.5.1. 7.8 

Table  2.5-4:  ParseCommandDone  CSU  [8.5.1.1.4] 
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2. 5. 1.1. 5  ParseDoKeywordTable  CSU 

This  CSU  executes  a  new  keyword  table. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

arac 

int 

Standard 

argyfl _ 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

(ParseUstO) 

int 

new  value  for  argc 

1  Calls  1 

Function 

Where  Described 

ParseUst 

Sec.  2.5.1. 1.2 

Table  2.5-5:  ParseDoKeywordTable  CSU  [8.5.1. 1.5] 


2.5. 1.2  par_const.c  CSC 

/simnet/libsrc/libparser/par_const.c 

This  file  contains  the  CSU  used  to  parse  constant  tables. 


Figure  2.5-3:  par_const.c  CSC  Structure 
2.5. 1.2.1  ParseGetConstant  CSU 


The  purpose  of  this  CSU  is  to  obtain  a  constant  value. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

ptr 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

argc 

int 

Standard 

aravfl 

pointer  to  char 

Standard 

ftabte 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 
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ReturnValues 


Return  Value 


PARSE  IGNORE 


PARSE  ERROR 


matched 


arac+1 


PARSE  UPDATE  LINE 


PARSE  ADDSPACE 


Calls 

Function 

Where  Described 

ParseGetToken 

Sec.  2.5.1. 7.6 

ParseError 

Sec.  2.5.1. 7.7 

ParseTableFind 

Sec.  2.5.1.7.11 

Parse  EscapeComplete 

Sec.  2.5.1.7.12 

Sec.  2.5.1.11  See  Aopendix  A 


ParseMatch  Sec.  2.5.1.7.10 


ParsePrint  Sec.  2.5. 1.9.3 


Table  2.5*6:  ParseGetConstant  CSU  [8.5.1.2.1] 


2.5. 1.3  par_copy.c  CSC 

/simnet/libsrc/libparser^ar_copy.c 
This  file  contains  one  CSU,  stringcopy. 


par_oopy.c 

CSC 

8.5.1. 3 


stringcopy 
CSU  8.5.1. 3.1 


Figure  2.5-4;  par_copy.c  CSC  Structure 


2. 5. 1.3.1  stringcopy  CSU 

This  CSU  copies  a  string  of  characters. 


Parameters 


inter  to  reoister  char 


ReturnValues 


char 


Parameters 


str 


Where  Tvoedef  Declared 


Standard 


Return  Value 


Meanin 


a  strino  that  was  copied 
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1  Calls  1 

Function 

Where  Described 

Alloc 

Sec.  2.5.1. 9.1 

Table  2.5-7:  stringcopy  CSU  [8.5.1.3.1] 


2.5. 1.4  par_edit.c  CSC 

/simnet/libsrc/libparser^ar_ediLc 

This  CSC  contains  the  CSUs  for  the  file  editing  commands. 


par_edit.c 

CSC 


8.5. 1.4 


1  _ 1 _ 

_ 1 _ 

r  ChangePrompt 

CSU  8.5.1. 4.1 

DC 

InitParser 

CSU  8.5.1. 4.2 

DC 

UpdateLine 

CSU  8.5.1. 4.3  J 

1 

1  " 

_ 1 _ 

r  UpdateMoveCursor 

V.  CSU  8.5.1. 4.4 

DC 

RedisplayLine 
CSU  8.5.1 .4.5 

in 

1 

1 

I 

f  NextChar 

V  CSU  8.5.1. 4.7 

DC 

MarkCursor 

CSU  8.5.1. 4.8 

JC 

RestoreCursor 

CSU  8.5. 1.4.9  J 

i 

. r . 

I 

f  EmptyLine 

V  CSU  8.5.1.4.10 

DC 

BeginningOt  Line 
CSU  8.5.1.2.11 

DC 

Backi  Char 

CSU  8.5.1.4.12  J 

1 

1 

EndOfLine 

CSU  8.5.1.4.14 

DC 

Forward  1  Char  ^ 

CSU  8.5.1.4.15  J 

- 1 - 

1  . . 

1 

r  GobbleWord 

V  CSU  8.5.1.4.16 

DC 

Deletel  Backward 
CSU  8.5.1.4.17 

DC 

KillForward  'N 

CSU  8.5.1.4.18  J 

1 

1  ■  ■  ■■  ■ 

... 

r  ClearLine 

V.  CSU  8.5.1.4.19 

DC 

LeftWord 

CSU  8.5.1.4.20 

DC 

RightWord  ^ 

CSU  8.5.1.4.21  J 

1 

'  1" 

...  J 

r  DeleteWord 

V  CSU  8.5.1.4.22 

DC 

InsertChar 

CSU  8.5.1.4.23 

DC 

FonwardChar  'N 

CSU  8.5.1.4.24  J 

—  . . T . 

. . 1  . . 

■■■| 

r  BackChar 

V  CSU  8.5.1.4.25 

DC 

DeleteChar 

CSU  8.5.1.4.26 

DC 

ScanForward  A 

CSU  8.5.1.4.27  J 

LookForward  \  ScanBackwards 

CSU  8.5.1 .4.28  J  \  CSU  8.5. 1.4.29 


Figure  2.5-5  par  edit.^^  CSC  Structure 
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2. 5. 1.4.1  ChangePrompt  CSU 
This  CSU  resets  the  parser  prompt. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

prompt 

pointer  to  char 

Standard 

Table  2.5>8:  ChangePrompt  CSU  [8.5.1.4.1] 


2.5. 1.4.2  InitParser  CSU 
This  CSU  initializes  the  parser. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

table 

pointer  to  PARSE  TABLE 

Sec.  2.5.1.11 

prompt 

pointer  to  char 

Standard 

loqsize 

int 

Standard 

ReturnValues 

Return  Value 

Type 

Meanina 

Me _ 

pointer  to  PARSE  DATA 

a  pointer  to  the  parser 

Calls 

Function 

Where  Described 

Alloc 

Sec.  2.5.1. 9.1 

Parse  Print 

Sec.  2.5.1. 9.3 

Table  2.5-9:  InitParser  CSU  [8.5.1.4.2] 


2.5. 1.4.3  UpdateLine  CSU 

This  CSU  is  the  "heart"  of  the  editor,  updating  what  is  on  the  screen  to  the  contents  of  the 
internal  input  buffer.  This  version  of  the  CSU  assumes  that  it  is  being  run  on  a  display 
capable  of  backspaces. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

UpdateMoveCursor 

Sec.  2.5.1. 4.4 

ParsePrint 

Sec.  2.5.1. 9.3 

Table  2.5-10:  UpdateLine  CSU  [8.5.1.4.3] 
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2.5. 1.4.4  UpdateMoveCursor  CSU 
This  CSU  updates  the  position  of  the  cursor. 


I  Parameters  \ 

Parameters 

Type 

Where  Typedef  Declared 

outbuf 

pointer  to  register  char 

Standard 

linebuf 

pointer  to  register  char 

Standard 

count 

register  int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

outbuf 

pointer  to  char 

oints  to  the  position  of  the 
cursor 

Table  2.5-11:  UpdateMoveCursor  CSU  [8.5.1.4.4] 

2. 5. 1.4. 5  RedisplayLine  CSU 

This  CSU  redisplays  the  current  line,  including  the  user  prompt.  The  calls  to  lock_wait 
and  lock_unlock  are  made  only  if  a  multiprocessor  system  is  being  used  (i.e.,  if 
MUTIPROCESSOR  is  defined). 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

pars::  data 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

lock  wait 

ParsePfint 

Sec.  2.5.1. 9.3 

UpdateLine 

Sec.  2.5.1. 4.3 

lock  unlock 

Table  2.5-12:  RedisplayLine  CSU  [8.5.1.4.5] 


2.5. 1.4.6  SetStopPoint  CSU 


This  CSU  informs  NextChar,  Sec.  2.5. 1.4.7,  where  to  stop  reading. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

at  cursor 

int 

Standard 

Tab(^.  2.5-13:  SetStopPoint  CSU  [8.5.1. 4.6] 
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2. 5. 1.4. 7  NextChar  CSU 

This  CSU  returns  the  next  character  from  the  input  buffer,  updating  the  buffer  curscn-,  if  it 
is  not  at  the  stop  point.  If  it  is  at  the  stop  point,  it  returns  >0'. 


Parameters 


pdp 


Parameters 


pointer  to  register 
PARSE  DATA 


Where  Typedel  Declared 


Sec.  2.5.1.11 


Return  Value 


•\0' 


o->Cur++ 


I  EH? 


ReturnValues 


Meanin 


End  of  line 


Next  character 


Table  2.5-14:  NextChar  CSU  [8.5.1.4.7] 


2. 5. 1.4. 8  MarkCursor  CSU 

This  CSU  marks  the  current  cursor  position  for  later  restoration. 


Parameters 


Parameters 


pdp 


IEi73 


pointer  to  register 
PARSE  DATA 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Table  2.5-15:  MarkCursor  CSU  [8.5.1.4.8] 


2.5. 1.4.9  RestoreCursor  CSU 

This  CSU  restores  the  cursor  to  the  last  cursor  mark. 


Parameters 


Parameters 


pdp 


IEi73 


pointer  to  register 
PARSE  DATA 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Table  2.5-16:  RestoreCursor  CSU  [8.5.1.4.9] 


2.5.1.4.10  EmptyLine  CSU 

This  CSU  determines  if  the  input  line  is  empty. 
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1  ReturnValues  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

Input  line  is  empty 

FALSE 

int 

Input  line  is  not  empty 

Table  2.5-17:  EmptyLine  CSU  [8.5.1.4.10] 


2.5.1.4.11  BeginningOfLine  CSU 

This  CSU  places  the  cursor  at  the  beginning  of  the  line. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Table  2.5-18:  BeginningOfLine  CSU  [8.5.1.4.11] 


2.5.1.4.12  BacklChar  CSU 

This  CSU  moves  the  cursor  back  one  character. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

I  Calls  I 

Function 

Where  Described 

BackChar 

Sec.  2.5.1.4.25 

Table  2.5-19:  BacklChar  CSU  [8.5.1.4.12] 


2.5.1.4.13  DeletelForward  CSU 
This  CSU  deletes  the  next  character  in  the  line. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

DeieteChar 

Sec.  2.5.1.4.26 

Table  2.5-20:  Deletel Forward  CSU  [8.5.1.4.13] 
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2.5.1.4.14  EndOfLine  CSU 


This  CSU  moves  the  cursor  to  the  end  of  the  line. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Table  2.5-21:  EndOfLine  CSU  [8.5.1.4.14] 


2.5.1.4.15  ForwardlChar  CSU 


This  CSU  moves  the  cursor  forward  one  character. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

I  Calls  I 

Function 

Where  Described 

ForwardChar 

Sec.  2.5.1.4.24 

Table  2.5-22:  ForwardlChar  CSU  [8.5.1.4.15] 


2.5.1.4.16  GobbleWord  CSU 


This  CSU  deletes  one  word  forward. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

LookForward 

Sec.  2.5.1.4.28 

DeleteChar 

Sec.  2.5.1.4.26 

Table  2.5-23:  GobbleWord  CSU  [8.5.1.4.16] 


2.5.1.4.17  DeletelBackward  CSU 


This  CSU  deletes  the  last  character. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 
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1  Calls  1 

Function 

Where  Described 

BackChar 

Sec.  2.5.1.4.25 

DeleteChar 

Sec.  2.5.1.4.26 

Table  2.5-24:  Del etel Backward  CSU  [8.5.1.4.17] 

2.5.1.4.18  KillForward  CSU 

This  CSU  deletes  the  characters  from  the  cursra  posititMi  to  the  end  of  the  line. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

DeleteChar 

Sec.  2.5.1.4.26 

Table  2.5-25:  KillForward  CSU  [8.5.1.4.18] 
2.5.1.4.19  ClearLine  CSU 

This  CSU  is  used  after  successfully  parsing  a  line.  It  clears  pdp. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Table  2.5-26:  ClearLine  CSU  [8.5.1.4.19] 


2.5.1.4.20  LeftWord  CSU 


This  CSU  moves  the  cursor  one  word  to  the  left. 


I  Parameters 

Parameters 

Type 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

ScanBackwards 

Sec.  2.5.1.4.29 

BackChar 

Sec.  2.5.1.4.25 

Table  2.5-27  LeftWord  CSU  [8.5.1.4.20] 
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2.5.1.4.21  RightWord  CSU 

This  CSU  moves  the  cursor  one  word  to  the  right 


Parameters 


Parameters 


pdp 


pointer  to  register 
PARSE  DATA 


Where  Tvoedef  Declared 


Sec.  2.5.1.11 


Calls 


Function  Where  Described 


ScanForward  Sec.  2.5.1.4.27 


ForwardChar  Sec.  2.5.1.4.24 


Table  2.5-28:  RightWord  CSU  [8.5.1.4.21] 


2.5.1.4.22  DeleteWord  CSU 
This  CSU  deletes  the  last  word. 


Parameters 


Parameters 


pdp 


IE2TZ 


pointer  to  register 
PARSE  DATA 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Calls 

Function 

Where  Described 

ScanBackwards 

Sec.  2.5.1.4.29 

BackChar 

Sec.  2.5.1.4.25  ■ 

OeleteChar 

Sec.  2.5.1.4.26 

Table  2.5-29:  DeleteWord  CSU  [8.5.1.4.22] 


2.5.1.4.23  InsertChar  CSU 

This  CSU  inserts  a  character  at  the  current  position. 


Parameters 


Parameters 


pdp 


pointer  to  register 
PARSE  DATA 


register  char 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Standard 


Calls 

Function 

Where  Described 

ParsePrint 

Sec.  2.5.1. 9.3 

InsertChar 

Sec.  2.5.1.4.23 

BackChar 

Sec.  2.5.1.4.25 

Table  2.5-30:  InsertChar  CSU  [1- 
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2.5.1.4.24  ForwardChar  CSU 


This  CSU  moves  forward  a  specified  number  of  characters,  but  not  beyond  the  end  of  the 
string. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

count 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

Parse  Print 

Sec.  2.5.1 .9.3 

Table  2.5-31:  ForwardChar  CSU  [8.5.1.4.24] 


2.5.1.4.25  BackChar  CSU 


This  CSU  moves  back  a  specified  number  of  characters,  but  not  beyond  the  first  one. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

Sec.  2.5.1.11 

PARSE  DATA 

count 

register  int 

Standard 

Table  2.5-32:  BackChar  CSU  [8.5.1.4.25] 

2.5.1.4.26  DeleteChar 

CSU 

This  CSU  deletes  a  specified  number  characters. 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

Sec.  2.5.1.11 

PARSE  DATA 

count 

register  int 

Standard 

Calls 

Function 

Where  Described 

BackChar 

Sec.  2.5.1.4.25 

Table  2.5-33:  DeleteChar  CSU  [8.5.1.4.26] 
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2.5.1.4.27  ScanForward  CSU 


This  CSU  returns  a  pointer  to  the  next  word. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

£ _ 

pointer  to  char 

New  cursor  point 

Table  2.5-34:  ScanForward  CSU 

[8.5.1.4.27] 

2.5.1.4.28  LookForward  CSU 

This  CSU  returns  a  pointer  to  the  next  word  or  whitespace. 

1  Parameters  1 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

*P 

pointer  to  char 

Pointer  to  new  cursor 

Table  2.5-35:  LookForward  CSU  [8.5.1.4.28] 


2.5.1.4.29  ScanBackwards  CSU 


This  CSU  returns  a  pointer  to  the  previous  word. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

*D 

pointer  to  char 

Pointer  to  new  cursor 

Table  2.5-36:  ScanBackwards  CSU  [8.5.1.4.29] 
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2.5. 1.5  par_fields.c  CSC 

/simnet/libsrc/libparser/par_fields.c 

This  CSC  contains  the  CSUs  that  maintain  the  data  fields. 


c 


parjields.c 

CSC 

8.5. 1.5 

PareeG^ 
CSU  8.5.1 .5.1  J  V  CSU  8.5.1 .5.2  J  V  CSU  8.5.1. 5.3 

Figure  2.5*6:  par_fields.c  CSC  Structure 


2. 5. 1.5.1  ParseGetFields  CSU 

This  CSU  obtains  the  flag  bits. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

aroc 

int 

Standard 

argvl  1 

pointer  to  char 

Standard 

ftable 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

ReturnValues 

Return  Value 

Type 

Meaning 

(arac+2) 

int 

PARSE  IGNORE 

int 

PARSE  ERROR 

int 

PARSE  UPDATE  LINE 

int 

(argc)  

int 

Calls 

Function 

Where  Described 

ParseGetToken 

Sec.  2.5.1. 7.6 

ParseError 

Sec.  2.5.1 .7.7 

ParseTabteFind 

Sec.  2.5.1.7.11 

ParseEscapeComplete 

Sec.  2.5.1.7.12 

FieldGet 

Sec.  2.5.1. 5.3 

P  argO 

Sec.  2.5.1.11  See  Appendix  A 

ParseMatch 

Sec.  2.5.1.7.10 

ParsePrint 

Sec.  2.5.1. 9.3 

Table  /.5-37:  ParseGetFields  CS!'  [8.5.1.5.11 
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2.5. 1.5.2  TypeFields  CSU 

This  CSU  is  used  to  type  the  fields  symbolically. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

ftable 

pointer  to  PARSE  TABLE 

Sec.  2.5.1.11 

flaa 

int 

Standard 

Calls 

Function 

Where  Described 

ParsePrint 

Sec.  2.5.1 .9.3 

FieldGet 

Sec.  2.5. 1.5.3 

Table  2.5-38:  TypeFields  CSU  [8.5.1.5.2] 
2.5. 1.5.3  FieldGet  CSU 

This  CSU  returns  the  field  name  associated  with  a  bit  pattern. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

ftable 

pointer  to  PARSE  TABLE 

Sec.  2.5.1.11 

bit 

int 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

(D  araO(otr)) 

pointer  to  char 

Reid  name 

("«bad  field»-) 

pointer  to  char 

ReU  is  bad 

Calls 

Function 

Where  Described 

D  araO 

Sec.  2.5.1.11  See  Appendix  A 

Table  2.5-39: 
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2.5. 1.6  parjib.c  CSC 
/simnet/libsrc/libparser^wjib.c 


This  CSC  consists  of  a  library  of  parsing  routines.  In  addition,  there  are  two  define  tables 
g_ParseYesNo  and  g  parseOnOff  used  by  the  "yes/no"  and  "(WofF'  macros. 


par  lib.c 

CSC 

8.5. 1.6 

1 

ParseGatHex 

'N  A  ParseGetOctal 

CSU  8.5.1. 6.2 

J  ^  CSU  8.5.1. 6.3 

- 1 - 

■  ""T-  ■ 

■  "  "  ~l _ 

f  ParseGetString  A  f 

ParsePutArg 

V  CSU  8.5.1. 6.4  J  V 

c 


ParseConvertNumber 


Figure  2.5-7:  parjib.c  CSC  Structure 


2. 5. 1.6.1  ParseGetDecimal  CSU 

This  CSU  returns  a  decimal  number  by  means  of  a  call  to  ParseConvertNumber. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

aroc 

int 

Standard 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

1  ReturnValues  1 

Retuf  !^  Value 

Type 

Meaning 

(ParseConvertNumber  (argc, 
argv,  pdp.  arg2, 10, 

"decimani 

int 

A  parse  return  status  or  new 
argc  value 

1  Calls  1 

Function 

Where  Described 

ParseConvertNumber 

Sec.  2.5.1. 6.7 

Table  2.5-40:  ParseGetDecimal  CSU  [8.5.1.6.1] 
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2. 5. 1.6.2  ^arseGetHex  CSU 

This  CSU  returns  a  hexidecimal  number  by  means  of  a  call  to  ParseConvertNumber. 


Parameters 


pdp 


Return  Value 


Function 


ParseConvertNumber 


Parameters 


pointer  to  register 
PARSE  DATA 


int 


inter  to  char 


inter  to  char 


ReturnValues 


Calls 


Where  Described 


Sec.  2.5.1. 6.7 


Where  Tvoedef  Declared 


Sec.  2.5.1.11 


Standard 


Standard 


Standard 


Meanin 


A  parse  return  status  or  new 
value 


Table  2.5-41:  ParseGetHex  CSU  [8.5.1.6.2] 


2.5. 1.6.3  ParseGetOctal  CSU 


This  CSU  returns  a  octal  number  by  means  of  a  call  to  ParscConvenNumber. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

aroc 

int 

Standard 

targvfl _ 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

1  ReturnValues  1 

■  Return  V;  r 

Type 

Meaning 

Hi— a 

int 

A  parse  return  status  or  new 
argc  value 

Calls  1 

Function 

Where  Described 

^arseConverlNu  Tiber 

Sec.  2.5.1. 6.7 

Table  2.5-42:  ParseGetOctal  CSU  rs.5.1.6.3] 
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2. 5. 1.6. 4  ParseGetString  CSU 

This  CSU  attempts  to  get  a  string.  The  returned  values  are  a  function  of  the  value  obtained 
from  a  call  to  the  CSU  ParseGetToken,  shown  in  the  "Meaning"  column. 


Parameters 


pdp 


Parameters 


pointer  to  register 
PARSE  DATA 


int 


inter  to  char 


inter  to  char 


Where  Tvoedef  Declared 


Sec.  2.5.1.11 


Standard 


Standard 


Standard 


Return  Value 


PARSEJGNORE 


PARSE  ADDSPACE 


ERROR 


ReturnValues 


Meanin 


int 

TOKEN  DATA,  new  value 

int 

TOKEN  ESCAPE  or 

TOKEN  QUESTION 

int 

TOKEN  EXHAUSTED 

int 

TOKEN  OPTIONAL  DONE 

int 

Other  value,  an  internal  error 

Error  Name 


ERROR 


Errors 


Reason  for  Error 


Returned  due  to  token  return  value  from  ParseGetToken  call 


Function 


ParseGetToken 


strinoco 


ParseMustFree 


ParseError 


ParsePrint 


Calls 


Where  Described 


Sec.  2.5.1. 7.6 


Sec.  2.5.1. 3.1 


Sec.  2.5.1 .7.4 


Sec.  2.5.1. 7.7 


Sec.  2.5.1. 9.3 


Table  2.5-43:  ParseGetString  CSU  [8.5. 1.6.4] 
2. 5. 1.6. 5  ParsePutArg  CSU 


This  CSU  puts  an  argument  into  the  input  stream. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

no  _pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

argc 

register  int 

Standard 

argvll _ 

pointer  to  char 

Standard 

pointer  to  char 

Standard 

'I 

Retu’-r  Values  1 

Return  Value 

Meaning  ! 

arqc+l 

int 

Status  or  new  argc  vai  j 

T  bk  2.5-44:  ParsePntA  CSI  [8.5.1.6.51 
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2. 5. 1.6. 6  ParseOptional  CSU 

This  CSU  processes  an  optional  argument  by  setting  the  pdp  optional  element  to  TRUE  and 
returning  the  passed  argument,  argc. 


Parameters 


pdp 


nu  a 


nu  ara2 


Parameters 


pointer  to  register 
PARSE  DATA 


reoister  int 


inter  to  char 


inter  to  char 


ins 


Where  Tvoedef  Declared 


Sec.  2.5.1.11 


Standard 


Standard 


Standard 


Return  Value 


lElT! 


ReturnValues 


Meanin 


Status  or  new  aroc  value 


Table  2.5-45:  ParseOptional  CSU  [8.5.1.6.6] 


2. 5. 1.6. 7  ParseConvertNumber  CSU 
This  CSU  obtains  a  number  of  a  specified  base. 


Parameters 


Parameters 


pdp 


2 


base 


bname 


pointer  to  register 
PARSE  DATA 


int 


inter  to  char 


inter  to  char 


int 


pointer  to  char 


Where  Tvoedef  Declared 


Sec.  2.5.1.11 


Standard 


Standard 


Standard 


Standard 


Standard 


ReturnValues 


Return  Value 


PARSE  ERROR 


arac+1 


PARSE  ADDSPACE 


PARSE  IGNORE 


Meanin 


llleoal  number 


New  value 


Not  a  number 


Not  a  number  as  exoected 


Old  value,  option  completed 


Calls 

Function 

Where  Described 

ParseGetToken 

Sec.  2.5.1. 7.6 

ParseError 

Sec.  2.5.1. 7.7 

ParsePrint 

Sec.  2.5.1. 9.3 

Table  2.5-46:  ParseConvertNumber  CSU  [8.5. 1.6.7] 
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2. 5. 1.7  par_util.c  CSC 

/simnet/libsr(^bparser4>ar_util.c 

This  CSC  contains  parser  auxilliaiy  CSUs. 


c 


r  DoCk>mmand 

V  CSU  8.5.1 .7.1 

DC 

DoHelp 

CSU  8.5.1. 7.2 

DC 

- 1 - ^ 

DoEscape  ^ 

CSU  8.5.1 .7.3  J 

1 

1  " 

...  j 

r  ParseMustFree 

V  CSU  8.5.1. 7.4 

DC 

ParsalnSat 

CSU  8.5. 1.7.5 

DC 

ParsaGatToken 

CSU  8.5.1. 7.6  y 

1 

1  ^ 

1 

^  ParsaError 

V  CSU  8.5.1. 7.7 

JC 

ParseMessage 
CSU  8.5.1. 7.8 

DC 

ParsaFindEndList 

CSU  8.5.1. 7.9  y 

1 

1 

1 

r  ParseMatch 

V  CSU  8.5.1.7.10 

JC 

ParsaTableFind 
CSU  8.5.1.7.11 

DC 

ParsaEscapaComF>lata  A 
CSU  8.5.1 .7.12  J 

uc 

CSU  8.5 


Figure  2,5-8:  par_util.c  CSC  Structure 


2. 5. 1.7.1  DoCommand  CSU 


This  CSU  processes  a  user  command. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

ParsePrint 

Sec.  2.5.1. 9.3 

SetStopPoint 

Sec.  2.5.1. 4.6 

Parseinput 

Sec.  2.5.1. 1.1 

Table  2.5-47:  DoCommand  CSU  [8.5.1.7.1] 
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2. 5. 1.7. 2  DoHelp  CSU 
This  CSU  processes  a  help  command. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

Function 

Where  Described 

InsertChar 

Sec.  2.5.1.4.23 

Update  Line 

Sec.  2.5.1 .4.3 

Deletel  Backward 

Sec.  2.5.1.4.17 

Parse  Print 

Sec.  2.5.1 .9.3 

SetStopPoint 

Sec.  2.5.1. 4.6 

Parseinput 

Sec.  2.5. 1.1.1 

Table  2.5-48:  DoHelp  CSU  [8.5.1.7.2] 


2. 5. 1.7. 3  DoEscape  CSU 

This  CSU  processes  an  escape  command. 


Parameters 


Parameters 


Type 


Where  Tvpedef  Declared 


pdp 


pointer  to  register 
PARSE  DATA 


Sec.  2.5.1.11 


Calls 


Function 


Where  Described 


SetStopPoint 


Sec.  2.5.1 .4.6 


Parseinput 


Sec.  2.5.1. 1.1 


Table  2.5-49:  DoEscape  CSU  [8.5.1.7.3] 


2. 5. 1.7. 4  ParseMustFree  CSU 

This  CSU  informs  the  parse  system  that  the  current  data  item  must  be  freed  when  the  parse 
is  done. 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

index 

int 

Standard 

Table  2.5-50:  ParseMustFree  CSU  [8.5. 1.7.4] 
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2.5. 1.7.5  ParselnSet  CSU 


This  CSU  determines  if  the  character  passed  is  in  the  set  used. 


i  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

ch 

reaister  char 

Standard 

set 

pointer  to  reoister  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meanina 

TRUE 

int 

Character  is  in  the  set  passed 

FALSE 

int 

Character  not  in  set  passed 

Table  2.5-51:  ParselnSet  CSU  18.5.1.7.5] 


2. 5. 1.7. 6  ParseGetToken  CSU 


This  CSU  obtains  the  next  user  token  and  acts  upon  it. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

tok 

pointer  to  pointer  to  register 
char 

Standard 

1  ReturnValues  1 

Return  Value 

Meanina 

TOKEN  OPTIONAL 
EXHAUSTED 

int 

Token  option  exhausted 

TOKEN  EXHAUSTED 

int 

Token  exhausted 

pdp->TokenTvpe 

int 

Token  value 

TOKEN  TYPE 

int 

Token  type 

1  Calls  1 

Function 

Where  Described 

MarkCursor 

Sec.  2.5.1. 4.8 

NextChar 

Sec.  2.5. 1.4.7 

ParselnSet 

Sec.  2.5.1. 7.5 

Table  2.5-52:  ParseGetToken  CSU  [8.5.1.7.61 
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2. 5. 1.7. 7  ParseError  CSU 
This  CSU  processes  an  error  message. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

ara2 

pointer  to  char 

Standard 

msai 

pointer  to  char 

Standard 

msq2 

pointer  to  char 

Standard 

msa3 

pointer  to  char 

Standard 

msa4 

pointer  to  char 

Standard 

msaS 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

Parse  Print 

Sec.  2.5.1. 9.3 

Table  2.5-53:  ParseError  CSU  [8.5. 1.7.7] 


2. 5. 1.7. 8  ParseMessage  CSU 
This  CSU  prints  a  user  message. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

message 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

ParsePrint 

Sec.  2.5. 1.9.3 

Table  2,5-54:  ParseMessage  CSU  [8.5.1.7.8] 


2.5. 1.7.9  ParseFindEndList  CSU 
This  CSU  Bnds  the  end  of  a  parse  table  block. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

first 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

end 

pointer  to  register 

PARSE  TABLE 

Sec.  2.5.1.11 

begin  tok 

int 

Standard 

end  tok 

int 

Standard 
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Table  2.5-55:  ParseFindEndList  CSU  [8.5.1.7.9] 


2.5.1.7.10  ParseMatch  CSU 

This  CSU  determines  if  a  token  matches  a  command  string. 


Parameters 


command 


token 


Return  Value 


TRUE 


FALSE 


Parameters 


e 


pointer  to  reoister  char 


pointer  to  reoister  char 


ReturnValues 


Where  Typedef  Declared 


Standard 


Standard 


Meanin 


Token  matches  command 


Token  not  eoual  command 


Calls 


Function  Where  Described 


uc  Sec.  2.5.1.7.13 


Table  2.5-56:  ParseMatch  CSU  [8.5.1.7.10] 


2.5.1.7.11  ParseTableFind  CSU 
This  CSU  searches  for  a  token  in  a  table. 


Parameters 


pdp 


table 


token 


escape  used 


entry 


Parameters 


e 


pointer  to  register 
PARSE  DATA 


inter  to  PARSE  TABLE 


inter  to  char 


int 


pointer  to  pointer  to 
PARSE  TABLE 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Sec.  2.5.1.11 


Standard 


Standard 


Sec.  2.5.1.11 
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\  ReturnValues  1 

Return  Value 

Meanina 

PARSE  IGNORE 

int 

Bad  name 

PARSE  ERROR 

int 

Bad  name 

PARSE  SUCCESS 

int 

Successful 

1  Calls  1 

Function 

Where  Described  1 

p  araO 

ii'i  ij— — — 

ParseMatch 

Sec.  2.5.1.7.10 

ParseError 

Sec.  2.5.1. 7.7 

Table  2.5-57:  ParseTableFind  CSU  [8.5.1.7.11] 


2.5.1.7.12  ParseEscapeComplete  CSU 


This  CSU  updates  a  token  in  the  input  string  upon  escape. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

token 

pointer  to  reaister  char 

Standard 

addspace 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

RestoreCursor 

Sec.  2.5.1. 4.9 

NextChar 

Sec.  2.5.1. 4.7 

InsertChar 

Sec.  2.5.1.4.23 

Table  2.5-58:  ParseEscapeComplete  CSU  [8.5.1.7.12] 


2.5.1.7.13  uc  CSU 


This  CSU  returns  an  uppercase  character  if  a  lower  case  one  is  passed;  otherwise,  it  returns 
the  passed  character. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

ch 

register  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

ch 

char 

Upper  case  character 

Table  2.5-59:  uc  CSU  [8.5.1.7.13] 
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2.5. 1.8  par_hist.c  CSC 
/simnet/libsrc/libparser,^)ar_hisLc 

This  CSC  contains  CSUs  that  implement  the  logging  of  conunands  issued  by  the  user  to 
the  parser. 

par_hist.c 

CSC 

8.5. 1.8 


CommandLog 
CSU  8.5.1. 8.1 


CopyEarlierCommand 
CSU  8.5.1. 8.2 


NextCommand 
CSU  8.5.1.8.4 


PreviousCommand 
CSU  8.5.1 .8.3 


Figure  2.5-9:  par_hist.c  CSC  Structure 


2. 5. 1.8.1  CommandLog  CSU 

This  CSU  issues  the  call  to  the  function  that  the  user  invoked  from  the  command  line.  It 
copies  the  command  line  into  a  buffer  that  has  a  QELEM  before  the  null  terminated 
command  line.  Then  it  attachs  the  buffer  to  the  end  of  the  parse  queque. 


Parameters 


pdp 


Parameters 


pointer  to  register 
PARSE  DATA 


Where  Typedef  Declared 


Sec.  2.5.1.11 


Calls 


Function  {Where  Described 


strinacopy  Sec.  2.5.1. 3.1 


Free  Sec.  2.5.1. 9.2 


Table  2.5-60:  CommandLog  CSU  [8.5.1.8.1] 


2.5. 1.8.2  CopyEarlierCommand  CSU 

This  CSU  is  used  to  restore  the  command  line  pointers  and  buffer  area  to  those  of  the 
"CurrentCommand"  QELEM  of  the  global  structure. 
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1  Calls  1 

Function 

Where  Described 

BeainninaOfLine 

Sec.  2.5.1.4.11 

KillForward 

Sec.  2.5.1.4.18 

InsertChar 

Sec.  2.5.1.4.23 

Table  2.5-61:  CopyEarlierCommand  CSU  [8.5. 1.8.2] 


2. 5. 1.8. 3  PreviousCommand  CSU 


This  CSU  travels  through  the  queue  using  the  tail  of  the  queue  and  the  previous  QELEM. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

Calls 

1  Function 

Where  Described 

!  CopyEarlierCommand 

Sec.  2.5. 1.8.2 

Table  2.5-62:  PreviousCommand  CSU  [8.5.1.8.3] 


2.5. 1.8.4  NextCommand  CSU 

This  CSU  travels  through  the  queue  using  the  head  of  the  queue  and  the  next  QELEM.  The 
routine  checks  if  the  earlier  command  is  the  same  as  the  current  command,  and  if  so, 
returns.  Otherwise,  it  increments  the  earlier  command  number.  If  it  is  not  at  the  end  of  the 
command  buffer  the  earlier  command  is  set  to  the  buffer  command.  If  the  pointer  to  the 
earlier  command  is  NULL,  the  earlier  command  is  set  to  the  current  command.  The  CSU 
issues  a  call  to  CopyEarlierCommand  and  returns. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

pdp 

pointer  to  register 

PARSE  DATA 

Sec.  2.5.1.11 

1  Calls  1 

Function 

Where  Described 

CopyEarlierCommand 

Sec.  2.5.1 .8.2 

Table  2.5-63:  NextCommand  CSU  [8.5.1.8.4] 


I 
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2.5. 1.9  par_unix.c  CSC 
/simnet/libsrc/libparser^)ar_unix.c 

This  CSC  contains  two  UNIX-based  functions.  Alloc  and  Free,  along  with  the  ParsePrint 
function.  The  contents  of  the  last  CSU  is  conditional  on  whether  OEJGINAL  is  defined. 


par  unix.c 
CSC 

8.5.1. 9 

1 

1 

1  ^  1 

1  1 

c  ^  r 

V  CSUB.S.1.9.1  J 


Free 

CSU  8.5.1 .9.2 


)C 


ParsePrint 
CSU  8.5.1. 9.3 


3 


Figure  2.5-10:  par_unix.c  CSC  Structure 


2.5. 1.9.1  Alloc  CSU 

This  CSU  returns  the  results  of  a  call  to  heap_calloc,  which  passes  as  parameters  1 
(number  of  memory  blocks)  and  size  (of  that  block).  The  size  is  the  integer  parameter 
passed  to  Alloc. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

size 

int 

Standard 

I  ReturnValues  1 

Return  Value 

Type 

Meanlnp 

heap  callocd, size) 

pointer  to  char 

Pointer  tc  heap 

1  Calls  1 

Function 

Where  Described 

heap  calloc 

Sec.  2.14.2.1.1 

Table  2.5-64:  Alloc  CSU  [8.5. 1.9.1] 

2. 5. 1.9. 2  Free  CSU 

This  CSU  calls  the  standard  library  function  free,  passing  the  character  pointer. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

pointer 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

free 

Sec.  2.5. 1.9.2 

Table  2.5-65:  Free  CSU  [8.5.1.9.21 
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2. 5. 1.9. 3  ParsePrint  CSU 

A  call  to  _dopmt  executes  the  "heart"  of  the  parse  printing  requirement.  If  ORIGINAL  is 
not  defined,  die  CSU  requires  that  varargs.h  be  included.  Only  if  the  ORIGINAL  define  is 
missing  are  the  functions  va.start  and  va_end  called.  In  addition,  the  second  parameter 
passed  becomes  va_alist,  defined  va_dcl,  instead  of  the  args  array. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

ctl 

pointer  to  char 

Standard 

arasfl 

int 

Standard 

Table  2.5-66:  ParsePrint  CSU  [8.5.1.9.3] 


2.5.1.10  kludge.c  CSU 

/simnet/libsrc/libparser/kludge.c 

This  file  consists  of  macros  expanding  calls  to  printf  statements  that  effectively  print  the 
names  of  the  character  strings.  These  consist  of:  ecmderr,  gethost,  isbadhost,  hostname, 
getnet,  isbadnet,  and  netfint.  They  are  expanded  in  Appendix  A. 


2.5.1.11  libparser.h  CSU 

/simnet/libsrc/libparser/libparser.h 

This  CSU  is  the  parser  header  file.  It  contains  constant  definitions,  various  tokens  and 
function  return  values,  definitions  to  create  parse  tables  (see  Appendix  A),  and  two 
structure  definitions,  PARSE_TABLE  and  PARSE_DATA.  TTie  following  tables  contain 
the  constant  definitions  and  the  two  structure  definitions. 

The  parser  constant  definitions  are  used  in  the  PARSE_DATA  structure  to  define  array 
sizes. 


Constant 

Value 

ARGSI2E 

30 

INPUTLINE 

140 

STRINGSI2E 

200 

Table  2.5-67:  Parser  Constant  Definitions 
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The  following  definitions  are  the  legal  parse  function  return  values. 


Constant 

Value 

PARSE  ERROR 

-1  r  Error  »nth  cursor  positioning  V 

PARSE  SUCCESS 

-2  r  Cleanup  and  start  new  command  */ 

PARSE  IGNORE 

-3  /*  Error  without  cursor  reposition  */ 

PARSE  NEEDKEYWORD 

-4  /*  Waiting  for  another  keyword  */ 

PARSE  UPDATE  LINE 

-5  r  Just  update  ine  and  try  again  */ 

PARSE  ADDSPACE 

-6  r  Add  space  to  end  of  line  */ 

Table  2.5-68:  Parser  Function  Return  Constant  Definitions 


The  following  are  the  legal  ParseGetToken,  Sec.  2.5. 1.7.6,  function  returns. 


Constant 

Value 

TOKEN  DATA 

1  /•  A  token  is  returned  V 

TOKEN  ESCAPE 

2  /*  A  token  is  returned,  it  ended  in  escape  V 

TOKEN  OUESTION 

3  /*  A  token  is  returned,  it  ended  in '?'  */ 

TOKEN  EXHAUSTED 

4  /*  No  token  is  returned,  input  exhausted  */ 

TOKEN  OPTION  DONE 

5  /*  Optional  input  exhausted  V 

Table  2.5-69:  ParseGetToken  Return  Constant  Definitions 


Constant 

Value 

FIELD  ADD 

1  /*  Add  to  current  value  */ 

FIELD  SUBTRACT 

2  r  Subtract  from  current  value  */ 

FIELD  REPLACE 

3  /*  Replace  with  current  value  */ 

Table  2.5-70:  FIELD  Change  Constant  Definitions 


Constant 

Value 

P  CALL 

1 

P  END  KEYWORD 

2 

P  END  KEYWORD  SELECT 

3 

P  KEYWORD 

4 

P  KEYWORD  SELECT 

5 

P  PARSE  FUNCTION 

6 

P  PARSE  KEYWORDS 

7 

P  PRINT 

8 

P  PRINTFIELD 

9 

Table  2.5-71:  Command  Token  Constant  Definitions 


Item 

Type 

Where  Type  Defined 

p  command 

int 

Standard 

p  arol 

pointer  to  char 

Standard 

p  aro2 

pointer  to  char 

Standard 

Table  2.5-72:  PARSE_TABLE  Structure  Definition 
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Item 

Type 

Where  Type  Defined 

TopLevel 

pointer  to  PARSE  TABLE 

Previous  structure 

TokenRr 

pointer  to  char 

Standard 

TokenTvpe 

int 

Standard 

Optional 

int 

Standard 

CommandBuffer 

pointer  to  pointer  to  char 

Standard 

CommandBufferEnd 

pointer  to  pointer  to  char 

Standard 

EarlierCommand 

pointer  to  pointer  to  char 

Standard 

CurrentCommand 

pointer  to  pointer  to  char 

Standard 

First 

pointer  to  char 

Standard 

Cur 

pointer  to  char 

Standard 

Last 

pointer  to  char 

Standard 

End 

pointer  to  char 

Standard 

SaveCur 

pointer  to  char 

Standard 

CursorMark 

pointer  to  char 

Standard 

Prompt 

pointer  to  char 

Standard 

StopPoint 

pointer  to  char 

Standard 

PrintAra 

long 

Standard 

LoQPunction 

FUNC  PTR 

ArovfARGSlZEI 

char 

Standard 

AroFreelARGSIZEl 

char 

Standard 

. . .  IH 

char 

Standard 

char 

Standard 

char 

Standard 

char 

Standard 

Table  2.5-73:  PARSE_DATA  Structure  Dennition 


2.5.2  Parser  Command  Processor  CSC 
2.5.2. 1  parser .c  CSC 

/simnet/src/host/parser.c 

This  CSC  contains  the  code  which  handles  user  input,  sending  it  directly  to  the  program 
from  the  terminal  window  where  the  phantom  was  started.  It  is  used  mainly  to  perform 
tasks  that  the  ordinary  user  would  not  want  to  perform,  or  should  not  be  allowed  to 
perform.  Almost  all  system  information  is  available  through  the  parser,  as  well  as  many 
debugging  and  development  aids. 
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parser.c 

CSC 

8.5.2. 1 

f  parser  init  A  t 

V  CSU  8.5.2. 1.1  J  ' 

^  parser  restore  term  A  f  parser  create  ^ 

^  CSU8.5.2.1.2  J  V  CSU8.5.2.1.3  J 

^ - ' - V 

f  set  command _printing  A  i 
CSU8.5.2.1.4  J  ' 

f  set_abort_on_error  f  set_ground  impact  mode^ 

1  CSU8.5.2.1.5  J  V  CSU  8.5.2. 1.6  J 

f  toggle  debugging  \ 

V  CSU  8.5.2.1.10  J 

r  show  vehicle  ids  A  A  count  vehicles  A 

^  CSU  8.5.2.1.11  J  ^  CSU  8.5.2.1.12  J 

r  count_sites  A  f  count_hosts  ^ 

V  CSU  8.5.2.1.14  /  V  CSU  8.5.2.1.15  ) 

r  show  connection  'N 

V  CSU  8.5.2.1.16  J 

. - 1 - V  ^ - 1 - . 

/  show  sbx  overlays  A  /  identify  exercise  A 

V  CSU  8.5.2.1.17  )  V  CSU  8.5.2.1.18  J 

^  i-  .  ~ 

/lookup  vehicle  with  range  A 

V.  check  CSU  8.5.2.1.19 

1  .  ^  1 - - 

f  show_vehicle  ^  /  vehicle  catastrophe  A 

V  CSU  8.5.2.1.20  J  V  CSU  8.5.2.1.21  J 

f  vehicle  fake  resupply  'A  f  vehicle  defuel  ^ 

V  CSU  8.5.2.1.23  J  \  CSU  8.5.2.1.24  J 

^  vehicle_ping  do 

V  CSU  81.2.1.25  J 

f  vehicle  bong  do  A  ^  stealth  set  symbols  draw  ^ 

V  CSU  875.2.1.26  J  \  tick  CSU  8.5.2.1.27  ) 

r  stealth  sat  mimic  on  A 
^  CSU  8.5.2.1.28  J 

f  stealth  set  mimic  off  A  ^  stealth  site  host_pair  A 

V  CSU  8.5.2.1.29  J  V  CSU  8.5.2.1.30  ) 

- 1 - 

f  stealth  attach  to  A 

V  CSU  8.5.2.1.31  J 

C  stealth  teleport  to  A  ^  parser  create  vehicle  A 

V  CSU  8.5.2.1.32  J  V  CSU  8.5.2.1.33  J 

r  countries_from_battlo_schemeV 
V  _and_lorce  CSU  8.5.2.1.34  J 

- - 1 - -  _ 1 - - 

f  parserjglobal  reset  A  f  parser  heap  statistics  A 

^  CSU  8.5.2.1.35  J  V  CSU  8.5.2.1.36  J 

r  parser_heap_vorify 

V  CSU  8.5.2.1.37  ) 

[  ^.int_reasons_and_clear  A  f  parser_heap_collect  A 

V  CSU  8.5.2.1.38  J  V  CSU  8.5.2.1.39  J 

. - ^ - V 

f  parser  send  string  A 

V  meters  CSU  8. 5. 2.1 .40  J 

V  CSU  8.5.2.1.41  J 

Figure  2.5-11:  parser.c  CSC  Structure 
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This  CSC  begins  by  undeflning  ENABLE_ADB,  important  because  of  conditional 
compiles  in  some  of  the  CSUs.  A  constant  definition  then  follows. 


Constant 


PARSER  STRING  SIZE 


Value 


128 


Table  2-74:  PARSER_STRING_SIZE  Constant  Definition 

This  constant  definition  defines  the  size  of  the  parser_title[  ]  and  parser_hostname[  I  arrays. 
Then  locally  used  variables  are  initialized,  stealth_addr  (type  SimulationAddiess)  is  set  to 
zero  {0, 0},  the  unsigned  int  g_stealth_draw_tick  is  set  to  5(XX),  and  g_stealth_miitiic  is  set 
to  TRUE. 


2. 5. 2. 1.1  parser_init  CSU 

This  CSU  strips  off  the  parser  host  name  and  prints  it  in  upper  case  letters. 


Function 


ethostname 


e 


arser  init 


Calls 


Where  Described 


Sec.  2.5.1.10 


Sec.  2.14.3.8.1 


iim 


Table  2.5-75:  parserjnit  CSU  [8.5.2.1.11 


2.5.2. 1.2  parser_restore_terni  CSU 

If  ENABLE_ADB  is  not  defined,  this  CSU  restores  initial  terminal  conditions  through  a 
call  to  tty_exit(). 


Function 


tty  exit 


Calls 


Where  Described 


Table  2.5-76:  parser_restore_terni  CSU  [8.5.2.1.2] 


2.5.2. 1.3  parser_create  CSU 

If  ENABLE_ADB  is  not  defined,  this  CSU  creates  a  parser  through  calls  to  parser_init() 
and  periodic_fncl(). 
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1  Calls  1 

Function 

Where  Described 

parser  init 

Sec.  2.5.2. 1.1 

periodic  fnci 

Sec.  2.2.1 .1.2 

ttv  tick 

Table  2.5-77:  parser_create  CSU  [8.5.2.1.3] 


2.5.2. 1.4  set_command_printing  CSU 

This  CSU  sets  g  print  command  to  TRUE  (to  print)  if  argv[0]  is  TRUE  (ON);  otherwise, 
it  sets  g  print  command  to  FALSE. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

aravf  1 

int 

Standard 

Table  2.5-78:  set_command_printing  CSU  [8.5.2.1.4] 


2.5.2. 1.5  set_abort_on_error  CSU 

This  CSU  sets  the  variable  g_abort_on_error  to  the  value  passed  in  argv[0]. 


1  Parameters  1 

Parameters 

wipnmmmmmmm 

Where  Typedef  Declared 

atoc 

int 

Standard 

int 

Standard 

I 


Table  2.5-79:  set_abort_on_error  CSU  [8.5.2.1.5] 


2. 5. 2. 1.6  set_ground_impact_mode  CSU 

This  CSU  sets  ^sbx_show_gi  to  TRUE  if  argv[0]  is  TRUE  (ON);  otherwise,  it  sets 
g_sbx_show_gi  to  FALSE.  The  CSU  also  prints  that  it  is  turning  the  ground  impact  mode 
(gi_mode)  on  or  off  as  appropriate. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

aravf  1 

int 

Standard 

Table  2.5-80:  set_ground_impact_mode  CSU  [8.5.2.1.6] 
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2. 5. 2. 1.7 


set  Indirect  fire  mode  CSU 


This  CSU  sets  g_sbx_show_if  to  TRUE  if  argv[0]  is  TRUE  (ON);  otherwise,  it  sets 
^sbx_show_if  to  FALSE.  The  CSU  also  prints  that  it  is  turning  the  indirect  fire  mode 
(ind_fire_mode)  on  or  off  as  appropriate. 


1  Parameters  1 

1  Parameters 

Type 

Where  Typedef  Declared 

Large _ _ 

int 

Standard 

int 

Standard 

Table  2.5-81:  set_indirect_fire_mode  CSU  [8.5.2.1.7] 


2. 5. 2. 1.8  set_header_printing  CSV 

This  CSU  sets  g_print_headers  to  TRUE  if  argv[0]  is  TRUE  (ON);  otherwise,  it  sets 
g_print_headers  to  FALSE. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

aroc 

int 

Standard 

a[al] _ 

int 

Standard 

Table  2.5-82:  set_header_printing  CSU  [8.5.2.1.8] 


2.5.2. 1.9 


set_monitor_period  CSU 


This  CSU  turns  on  the  performance  monitor  if  argv[0]  contains  a  non- zero  value.  The 
monitoring  frequency  is  contained  in  argv[0]  in  seconds.  The  period,  in  milliseconds,  is 
passed  in  a  call  to  perf_monitor_on().  If  argv[0]  is  zero,  the  p^ormance  monitor  is  turned 
off  via  a  call  to  perf_monitor_off().  In  either  case,  an  appropriate  message  is  displayed  to 
the  user. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

argjU 

int 

Standard 

Calls 

Function 

Where  Described 

perf  monitor  on 

Sec.  2.2.1 .4.1 

perf  monitor  off 

Sec.  2.2. 1.4.2 

Table  2.5-83:  set_monitor_period  CSU  [8.5.2.1.9] 
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2.5.2.1.10  toggle_debugging  CSU 


This  CSU  toggles  the  g_debug_flags  variable  as  a  function  of  the  current  conditions  of 
argvf  1]  and  argv[2]. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

argc _ 

int 

Standard 

int 

Standard 

Table  2.5*84:  toggle_debugging  CSU  [8.5.2.1.10] 


2.5.2.1.11  show_vehicle_ids  CSU 

This  CSU  prints  vehicle  information  on  the  conqx>sites,  local  vehicles,  stealth  local 
vehicles,  local  missiles,  and  remote  vehicles  (including  those  that  timed  out  or  deactivated). 


1  Parameters  1 

Parameters 

Tvpe 

Where  Typedef  Declared 

anoc 

int 

Standard 

JlMJ 

int 

Standard 

Calls 

Function 

Where  Described 

vehicle  manager  print 

Sec.  2.9.1. 3.4 

Table  2.5*85:  show  vehicle  ids  CSU  [8.5.2.1.11] 


2.5.2.1.12  count_vehicles  CSU 

This  CSU  counts  and  prints  the  number  of  vehicles,  including  composites,  local  vehicles, 
stealth  local  vehicles,  local  missiles,  and  remote  vehicles  (including  those  that  timed  out  or 
deactivated). 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

aroc 

int 

Standard 

afgvtl 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vehicle  manager  count 

Sec.  2.9.3.1.5 

Table  2.5*86:  count  vehicles  CSU  [8.5.2.1.12] 
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Table  2.5*87:  count_forces  CSU  [8.5.2.1.13] 

PriOT  to  the  count_sites  CSU,  the  parcer.c  CSC  contains  the  following  constant  defines  for 
the  number  of  sites  and  hosts. 


Constant 

Value 

NUMBER  OF  SITES 

65536 

NUMBER  OF  HOSTS 

65536 

Table  2.5-88:  Sites  and  Hosts  Constant  Definitions 


2.5.2.1.14  count  sites  CSU 


This  CSU  counts  and  prints  the  number  of  vehicles  at  each  of  the  sites. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

argc 

ml 

Standard 

amvtl 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vehicle  manaaer  count  sites 

Sec.  2.9.3.1.7 

Table  2.5*89:  count  sites  CSU  [8.5.2.1.14] 


2.5.2.1.13  count  forces  CSU 


This  CSU  counts  and  prints  the  number  of  forces  in  each  category,  including 
distinguished,  other,  observer,  and  target. 


I  Parameters  I 

Parameters 

Tvoe 

Where  Typedef  Declared 

aroc 

int 

Standard 

argvfl 

int 

Standard 

Calls 

Function 

Where  Described 

vehicle_manager_count_forc 

e 

Sec.  2.9.3.1.6 

2.5.2.1.15  count_hosts  CSU 

This  CSU  counts  and  prints  the  number  of  vehicles  on  each  of  the  hosts  at  a  site. 
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1  Calls  1 

Function 

Where  Described 

vehicle_manager_count_ 

hosts 

Sec.  2.9.3.1.8 

Table  2.5>90:  count  hosts  CSU  [8.5.2.1.15] 


2.5.2.1.16  show_connection  CSU 

This  CSU  calls  show_connection_all_sbx,  which  causes  all  open  ports  to  display  status 
information. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Deciared 

arqc 

int 

Standard 

amvfl 

int 

Standard 

Cans 

Function 

Where  Described 

show  connection  all  sbx 

Sec.  2.4.3.2.4 

Table  2.5>91:  show  connection  CSU  [8.5.2.1.16] 


2.5.2.1.17  show_sbx_overlays 


CSU 


This  CSU  calls  show_overlays_all_sbx,  which  causes  all  overlays  associated  with  each 
pon  to  be  displayed. 


1  Parameters  1 

Parameters 

Where  Typedef  Deciared 

arqc 

int 

Standard 

int 

Standard 

1  Caiis  1 

Function 

Where  Described 

show  overlays  all  sbx 

Sec.  2.4.3.2.7 

Table  2.5-92:  show_sbx_overlays  CSU  [8.5.2.1.17] 
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2.5.2.1.18  identify_exercise  CSU 

This  CSU  prints  the  exercise  identification,  including  whether  or  not  it  is  using  the 
SIMNETLAN. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

aravfl 

int 

Standard 

Table  2.5*93:  identify_exercise  CSU  [8.5.2.1.18] 


2.5.2.1.19  lookup_vehicle_with_range_check  CSU 

This  CSU  checks  if  the  identification  number  of  a  vehicle  is  within  the  vehicle  range.  If  the 
vehicle  id  is  within  range,  it  checks  both  type  and  id,  and  returns  the  results  of  the  check. 

If  the  vehicle  id  is  too  high,  it  returns  NULL. 


1  Parameters  I 

Parameters 

Where  Typedef  Declared 

id 

unsianed  int 

Standard 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meanina 

LOOKUP  VEHICLErid.  tvoe) 

pointer  to  SAP  OBJECT 

Vehicle  status 

NULL 

pointer  to  SAF  OBJECT 

Vehicle  id  too  hiah 

1  Calls  1 

Function 

Where  Described  1 

LOOKUP  VEHICLE 

Table  2.5-94:  lookup_vehicIe_with_range_check  CSU  [8.5.2.1.19] 


2.5.2.1.20  show  vehicle  CSU 


This  CSU  determines  if  a  vehicle  passed  in  argv[0]  exists.  If  it  does  not  exist,  the  CSU 
prints  that  it  can  not  locate  it.  If  it  does  exist,  it  calls  show. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

argc 

int 

Standard 

aiaju _ 

int 

Standard 

Calls 

Function 

Where  Described 

lookup_vehicle_with_range_ 

check 

Sec.  2.5.2.1.19 

show 

Sec.  2.14.1.1.4 

Table  2.5-95:  show_vehicle  CSU  [8.5.2.1.20] 


179 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2.5.2.1.21  vehicle_catastrophe  CSU 

This  CSU  calls  vehicle.kill,  passing  argv[0]  as  the  vehicle  to  be  killed. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

argc 

int 

Standard 

amvll 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vehicle  kill 

Sec.  2.3.1. 2 

Table  2.5-96:  vehicle_catastrophe  CSU  [8.5.2.1.21] 


2.5.2.1.22  vehicle_resupply  CSU 

This  CSU  detennines  if  a  local  vehicle  passed  in  argv[0]  exists.  If  it  does  not  exist,  the 
CSU  prints  that  it  can  not  locate  it.  If  it  does  exist,  it  calls  start_resupply_of_to. 


i  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

aroc 

int 

Standard 

arsyu 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

lookup_vehicle_with_range_ 

check 

Sec.  2.5.2.1.19 

start  resupply  of  to 

Sec.  2.6.6.1.4 

Table  2.5-97:  vehicle_resupply  CSU  [8.5.2.1.22] 


2.5.2.1.23  vehicle_fake_resupply  CSU 

This  CSU  determines  if  a  local  unit  passed  in  argv[0]  exists.  If  it  does  not  exist,  the  CSU 
prints  that  it  can  notlocate  it.  If  it  does  exist,  it  calls  fake_resupply. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvoedef  Declared 

aroc 

int 

Standard 

mA} 

int 

Standard 

Calls 

Function 

Where  Described 

lookup_vehicle_with_range... 

check 

Sec.  2.5.2.1.19 

fake  resupply 

Sec.  2.14.1.1.12 

Table  2.5-98:  vehicle_fake_resupply  CSU  [8.5.2.1.23] 
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2.5.2.1.24  vehicle  defuel  CSU 


This  CSU  determines  if  a  local  vehicle  passed  in  ar^[0]  exists.  If  it  does  not  exist,  the 
CSU  prints  diat  it  can  not  locate  it.  If  it  does  exist,  it  sets  the  range  remaining  (vehicle  -> 
saf_vehicle  ->  range_remaining)  to  zero. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

argc 

int 

Standard 

argyM 

int 

Standard 

Calls 

Function 

Where  Described 

lookup_vehlcle_with_range_ 

check 

Sec.  2.5.2.1.19 

Table  2.5-99:  vehicle  defuel  CSU  [8.5.2.1.24] 


2.5.2.1.25  vehicle_ping_do  CSU 


This  CSU  calls  vehicle_ping,  which  applies  a  mild  vehicle  impact. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

aroc 

int 

Standard 

ESnlilUHHHHHHHHI 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

vehicle  pinq 

Sec.  2.3.1. 6 

Table  2.5-100:  vehicle_ping_do  CSU  [8.5.2.1.25] 


2.5.2.1.26  vehicle_bong_do  CSU 


This  CSU  calls  vehicle_bong,  which  applies  a  deadly  vehicle  impact 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard 

arayf] 

int 

Standard 

Calls 


Function 

Where  Described 

vehicle  bonq 

Sec.  2.3.1. 5 

Table  2.5-101:  vehicle_bong_do  CSU  [8.5.2.1.26] 
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2.5.2.1.27 


stealth_set_symbols_draw_tick 


CSU 


This  CSU  sets  the  stealth  updating  time  (g_stealth_draw_tick)  to  the  value  passed  in 
argv[0],  adjusted  to  millisecond  resolution. 


[  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

argc 

int 

Standard 

arcMl 

int 

Standard 

Table  2.5-102:  steaIth_set_symbols_draw_tick  CSU  [8.5.2.1.27] 


2.5.2.1.28  stealth_set_iniinic_on  CSU 
This  CSU  sets  g_stealth_mimic  to  TRUE. 


2.5.2.1.29  stealth_set_mimic_off  CSU 
This  CSU  sets  g_stealth_mimic  to  FALSE. 


2.5.2.1.30  stealth_site_host_pair  CSU 


This  CSU  sets  the  stealth  address  site  and  host  pair  from  parameters  passed  in  argv[  ]. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

aroc 

int 

Standard 

int 

Standard 

Table  2.5-103:  steaIth_site_host_pair  CSU  [8.5.2.1.30] 


2.5.2.1.31  stealth_attach_to  CSU 

liiis  CSU  determines  if  a  local  vehicle  passed  in  argv[0]  exists.  If  it  does  not  exist,  the 
CSU  prints  that  it  can  not  locate  it  If  it  does  exist  it  tests  to  see  if  the  stealth  site  host  pair 
exists.  If  the  host  pair  does  not  exist,  it  requests  the  stealth  address.  If  the  site  does  exist 
the  vehicle  is  "teleported"  to  the  site,  avoiding  collision,  and  is  attached  to  the  vehicle  there. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

aroc _ 

int 

Standard 

int 

Standard 
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Calls 

Function 

Where  Described 

lookup_vehicle_with_range_ 

check 

Sec.  2.5.2.1.19 

Sec.  2.14.3.5.17 


Sec.  2.9. 1.1  See  Aooendix  A 


vec  CO 


OBJ  POSITON 


stealth  send  teleport  to 


stealth_send_attachjo_ 

vehicle 


Table  2,5-104:  steaIth_aUach_to  CSU  [8.5.2.1.31] 
2.5.2.1.32  stealth_teleport_to  CSU 

This  CSU  determines  if  the  stealth  site  host  pair  exists.  If  the  host  pair  does  not  exist,  it 
requests  the  stealth  address.  If  the  site  does  exist,  the  vehicle  is  "teleported"  to  the  site. 


Parameters 


E171I 


Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Calls 

Function 

Where  Described 

tdb  net  z 

Sec.  2.14.1.2.3 

deo  to  rad 

Sim  macros.h 

stealth  send  teleport  to 


Table  2.5-105;  steaUh_teleport_to  CSU  [8.5.2.1.32] 
2.5.2.1.33  parser_create_vehicle  CSU 

This  CSU  initializes  all  the  parameters  for  a  vehicle.  It  creates  the  vehicle  as  a  top  level 
unit,  updating  the  owner's  top  level  unit  information. 


Parameters 


Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Function 


et  symbol 


tdb  aet  al 


countrles_from_battle_ 
scheme  and  force 


create  unit 


Calls 


Where  Described 


Sec.  2.1. 1.3.2 


Sec.  2.141.1.2.2 


Sec.  2.5.2.1.34 


Sec.  2.4.3.2.5 


Sec.  2.11.1.2 


Table  2.5-106:  parser_create_vehicle  CSU  [8.5.2.1.33] 
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2.5.2.1.34  countries_from_battle_scheme_and_force  CSU 

This  CSU  sets  the  countries  fen*  the  offensive  and  defensive  forces  according  to  the  battle 
scheme  and  force  identification  passed. 


1  Parameters  1 

Parameters 

Type 

Where  Tvoedef  Declared 

battle  scheme 

BattleScheme 

forcelD 

ForcelD 

CD 

pointer  to  unsianed  char 

Standard 

cO 

pointer  to  unsiqned  char 

Standard 

Calls 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5.2.2 

Table  2.5-107:  countries  from_battle  scheme_and  force  CSU 

[?.5.2.1.341" 


2.5.2.1.35  parser_global_reset  CSU 

This  CSU  calls  saf_complete_reset,  which  completely  resets  all  current  SAP  vehicles. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

aroc 

int 

Standard 

ajSJU 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

saf  complete  reset 

Sec.  2.2.4.1 

Table  2.5-108:  parser_globaI_reset  CSU  [8.5.2.i.35J 

At  this  point  in  the  parser.c  CSC,  two  additional  constants  are  defined  for  use  by  the 
remaining  CSUs. 


Constant 

Value 

STAT  LONG 

0x01 

STAT  SHORT 

0x10 

Table  2.5-109:  STAT_LONG  and  STAT_SHORT  Constant  Definitions 


2.5.2.1.36  parser_heap_statistics  CSU 

This  CSU  determines,  from  the  flag  passed  in  argv[l],  whether  or  not  to  do  a  long  version 
of  the  heap  statistics.  The  decision  is  passed  as  a  parameter  in  a  call  to  do_heap_statistics, 
which  does  the  actual  woric. 
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1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

arqc 

int 

Standard 

argv[] _ 

int 

Standard 

Calls 

Function 

Where  Described 

do  heap  statistics 

Sec.  2.14.2.1.17 

Table  2.5-110:  parser_heap_statistics  CSII  [8.5.2.1.36] 


2.5.2.1.37  parser_heap_verify  CSU 


This  CSU  calls  do_heap_verify. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

aroc 

int 

Standard 

argv[] _ 

int 

Standard 

Calls 

Function 

Where  Described 

do  heap  .verify 

Sec.  2.14.2.1.16 

Table  2.5-111:  parser_heap_verlfy  CSU  [8.5.2.1.37] 


2.5.2.1.38  print_reasons_and_clear  CSU 

This  CSU  calls  print_reasons  followed  by  clear_monitior_variables. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

aroc 

int 

Standard 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  reasons 

clear  monitor  variables 

Table  2.5-112:  print_reasons_and_clear  CSU  [8.5.2.1.38] 


) 
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2.5.2.1.39  parser_heap_collect  CSU 


This  CSU  calls  do_heap_collecL 


Parameters 


Parameters 


Where  Typedef  Declared 


Standard 


Standard 


Function 


do  heao  collect 


Calls 


Where  Described 


Sec.  2.14.2.1.18 


Table  2.5-113:  parser_heap_collect  CSU  [8.5.2.1.39] 


2.5.2.1.40  parser_set_targetmg_parameters  CSU 

This  CSU  determines  if  the  specified  unit  exits.  If  it  does  not  exist,  it  prints  a  message 
stating  this  fact.  If  the  unit  does  exist,  it  calls  set_targeting_parameters  to  set  the  targeting 
parameters. 


Parameters 


Parameters 


Where  Tvoedef  Declared 


Standard 


Standard 


Calls 


Function  Where  Described 


lookup_vehicle_with_range_  Sec.  2.5.2.1.19 
check 


set  taroetino  parameters  Sec.  2.14.1.1.7 


Table  2.5-114:  parser_set_targeting_parameters  CSU  [8.5.2.1.40] 

2.5.2.1.41  parser_send_string  CSU 

This  CSU  sends  a  port  number  message  passed  as  a  parameter  in  a  call  to  sbx^rintf. 


Parameters 


Parameters 


Function 


sbx  printf 


Calls 


Where  Described 


Sec.  2.4.3.2  8 


Where  Tvoedef  Declared 


Standard 


Standard 


Table  2.5-115:  parser_send_string  CSU  [8.5.2.1.41] 
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The  remaining  portion  of  the  parser.c  CSC  consists  of  executable  parser  table  macros.  The 
expansions  for  these  macros  are  in  libparser.h  (Sec.  2.5. 1.1 1),  and  the  macros  are  shown 
with  their  expansions  in  Appendix  A.  The  constants  that  compose  the  debugging  (D_)  and 
show  command  modifiers  for  these  macros  are  in  the  tables  in  debug.h  (Sec.  2.5.2.2). 


FIELDJTABLE  (debuggingjable) 

FIELD  Ccollisions*,  D_COLLISiON,  *- collision  detector) 

FIELD  ('composite*,  D_COMPOSITE,  *-  composite  unit  debugging’) 
FIELD  ('connection',  D_CONNECTION,  *- sbx  connectbn  debugging*) 


FIELD  Ccm’, 

FEU)  Cdriver, 
FELD  rglobar, 
FIELD  (*gunner, 
FIELD  (’intervis*, 
FIELD  (’reporter, 
FIELD  (loader, 
FELD  rmtssHe*, 
FIELD  (’navigator, 
FIELD  (’obstacles’, 
FIELD  rpilot',  I 

FIELD  (’remote*, 
FIELD  (’station’, 
FIELD  (tactical”, 
FIELD  (targeting*, 
FELD  (turrer,  I 

FELD  ("vehicle’, 
FIELD  (tweapons*. 


D_CM,  ’-  control  measures  and  overlays’) 

D_DRIVER,  ’-  driver  debugging’) 
DjGLOBAL,  ’-all  debugging*) 

DjGUNNER,  *•  gunner  debusing*) 
DJNTERVIS,  ’-  intervisibility*) 

D_REPORTER,  *-  report  generation’) 
D_LOADER,  ’-loader  debugging’) 
D_MISSlLE,  ’-  missile  debugging^ 
D_NAVIGATOR,  ’-  navigator) 

,  DjOBSTACLE,  ’-  obstacle  avoider) 
D_PILOT,  *-  pibt  debugging") 

D_REMOTE,  *-  remote  vehicle  debugging") 
D_STATION,  *-  station  keeper") 
D_TACTICAL,  ’-  tactical  state") 
D_TARGETING,  ’-  targeting  debugging*) 
DJTURRET,  ■-  tunet  debugging*) 

D_VEHICLE,  ’-  vehicle  de^ging’) 


FIELD  (tweapons*,  D_WEAPON,  *-  weapon  systems’) 
FIELD  ("groundveh*,  DjGROUND,  *-  ground  vehicle*) 
FIELD  rdriver,  D_DRIVER,  ’-driver) 

FIELD  ("airveh",  D_AIR,  *•  air  vehicle") 

END  FIELD  TABLE 


Table  2.5-116:  FIELD_TABLE  (debuggingjable) 
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DEFINE_TABLE  (setjable) 

KEYWORD_SELECT  ("  Options  for  the  sot  command*) 

KEYWORD  (*command_printing*,  *-  printing  of  SBX  commands  on/off") 
GET_ON_OR_OFF 
CALL  (setjcommand_printing) 

END_KEYWORD 

KEYWORD  ('abort_on_orror',  *-  if  on  error  checks  will  call  abort*) 
GET_ON_OR_OFF 
CALL  (set_abort_on_orror) 

END_KEYWORD 

KEYWORD  (*groundJmpact_mode*.  *-  display  of  ground  impacts  on/off*) 
GET_ON_OR_OFF 
CALL  (set jgroundJmpact_mode) 

END_KEYWORD 

KEYWORD  (*header_printing*,  *-  printing  of  SBX  headers  on/off*) 
GET_ON_OR_OFF 
CALL  (set_header_printing) 

END_KEYWORD 

KEYWORD  (*indiroct_firo_mode*,  *-  display  of  indirect  fire  on/off*) 
GET_ON_OR_OFF 
CALL  (setJndirectJire_mode) 

END_KEYWORD 

KEYWORD  (*monKor_period*,  *•  period  for  scheduler  monitor*) 
GETDECIMALC|period  in  seconds*) 

CALL  (set_monitor_period) 

END_KEYWORD 

END_KEYWORD_SELECT 

END  DEFINE  TABLE  _  _ 


Table  2.5-117:  DEFINE  TABLE  (set  table) 


DEFINE_TABLE  (notjablo) 

KEYWORD_SELECT(“  Options  for  the  net  command*) 

KEYWORD  ("stats*,  *-  print  simnet  statistics*) 

CALL  (simnetjgetstats) 

END_KEYWORD 

KEYWORD  ("zero”,  *-  zero  out  the  simnet  statistics*) 
CALL  (simnet_zerostats) 

END_KEYWORD 

KEYWORD  (Ihresholding*,  *-  get  thresholding  statistics*) 
CALL  (print_roasons_and_clear) 

END_KEYWDRD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-118:  DEFINE_TABLE  (netjable) 
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Table  2.5-119:  DEFINE_TABLE  (heap_stat_table) 

DEFINE_TABLE  (hashing_table) 

KEYWORD_SELECT(“  Options  for  the  hashing  command*) 

KEYWORD  (*collact*,  *-  start  collecting  id  hashing  statistics*) 

CALL  (start_collecting_id_hashing_statistics) 

END_KEYWORD 

KEYWORD  ('reporT,  *•  report  collected  id  hashing  statistics*) 

CALL  (report_id_hashing_statistics) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-120:  DEFINE_TABLE  (hashing  table) 


Di  INE_TABLE  (heapjable) 

KEYWORD_SELECT{*  Options  for  the  heap  command*) 

KEYWORD  (*oollect*,  *•  force  a  collect  on  a  heap*) 

CALL  (parser_heap_oollect) 

END_KEYWORD 

KEYWORD  (*statistics*,  *-  print  statistics  for  a  heap*) 
GETFIELDS  (heap_stat_table) 

CALL  (parser_heap_statistics) 

END_KEYWORD 

KEYWORD  ("verify*,  *-  verify  the  consistency  of  a  heap’) 
CALL  (parser_heap_verify) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-121:  DEFINE_TABLE  (heapjable) 
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DEFINE.TABLE  (printjable) 

KEYWORD_SELECT(*  Options  lor  the  print  command*) 

KEYWORD  Cbuffers*,  *-  number  of  buffers  allocated*) 

CALL  (buffer_statistics_print) 

END_KEYWORD 

KEYWORD  fconnections*,  *-  connection  status*) 

CALL  (showjoonnection) 

END.KEYWORD 

KEYWORD  foount*,  *•  count  of  vehicles  in  simnet*) 

CALL  (count_vehicles) 

END_KEYWORD 

KEYWORD  (*exercjse*,  *-  exercise  that  this  phantom  is  running  in  *) 
CALL  (identify_exercise) 

END_KEYWORD 

KEYWORD  (*hosts*,  *-  count  of  vehicles  by  hosts*) 
GETDECIMAL(*site  from  which  to  look  at  hosts*) 

CALL  (oount_hosts) 

END_KEYWORD 

KEYWORD  (*forcos*,  *-  count  of  vehicles  by  force*) 

CALL  (countjorces) 

END_KEYWORD 

KEYWORD  (*overlays*,  *-  overlays*) 

CALL  (show_sbx_ovarlays) 

END_KEYWORD 

KEYWORD  (*sites*.  *-  count  of  vehicles  by  site*) 

CALL  (cQunt_sKes) 

END.KEYWORD 

KEYWORD  (*vehicles*,  *•  id's  of  current  vehicles*) 

CALL  (show_vehicle_ids) 

END_KEYWORD 

KEYWORD  (*version*,  *-  version  of  phantom  program*) 

CALL  (identify_version) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-122;  DEFINE_TABLE  (printjable) 

DEFINE_TABLE  (parser_reset_table) 

KEYWORD_SELECT(*  Please  confirm...*) 

KEYWORD  (*yos*,  *-  Reset  the  phantom  (WARNING:  THIS  CLEARS  EVERYTHING)*) 
CALL  (pai^rjglobal_reset) 

END_KEYWORD 

KEYWORD  (*no*,  *-  Abort  reset  operation*) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-123:  DEFINE_TABLE  (parser  reset Jable) 
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DEFINEJTABLE  (stealthjable) 

KEYWORD_SELECT  (*  Options  for  the  stealth") 

KEYWORD  ("setjick",  *-  set  time  in  seconds  for  symbolics  drawing  of  stealth") 
GETDECIMAL  ("time  in  seconds") 

CALL  (stealth_set_symbolics_draw_tick) 

END_KEYWORD 

KEYWORD  ("address",  "•  set  site  host  pair  for  stealth  to  talk  to") 

GETDECIMAL  ("site") 

GETDECIMAL  (Tiost") 

CALL  (stealth_site_host_pair) 

END_KEYWORD 

KEYWORD  ("teleport", "-  send  stealth  to  specified  x  y  location") 

GETDECIMAL  ("X  positbn") 

GETDECIMAL  ("Y  position") 

GETDECIMAL  ("math  degrees") 

CALL  (stealth_teleport_to) 

END_KEYWORD 

KEYWORD  ("attachjo", "-  attach  stealth  to  specified  vehicle") 
GETDECIMALCVehicle  id") 

CALL  (steahh_attach_to) 

END_KEYWORD 

KEYWORD  ("mimic", "-  mode  for  stealth,  attach  or  mimic(default)”) 
DO_KEYWORD_TABLE(stealth_mode) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 

Table  2.5-128:  DEFINE^TABLE  (stealthjable) 
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DEFINE.TABLE  (vshiclajable) 

KEYWORD_SELECT  {*  Options  for  the  vehicle  command*) 

KEYWORD  Cbong*.  *-  deadly  vehicle  impacT) 

CALL  (vehicle_bongLdo) 

END.KEYWORD 

KEYWORD  CdefueT,  *-  wipe  out  a  vehicle's  fuel  supply  (TANKS  ONLY)*) 
CALL  (vehicle  defuel) 

END_KEYWORD 

KEYWORD  (Take*,  *-  fake  resupply  a  vehicle*) 

CALL  (vehiclejake_resupply) 

END_KEYWORD 

KEYWORD  (Tdir,  *•  catastrophic  vehicle  kiir) 

CALL  (vehidejcatastrophe) 

E^®_KEYWORD 

KEYWORD  rping*.  *-  mild  vehicle  impact*) 

CALL  (vehicle_ping_do) 

END_KEYWORD 

KEYWORD  (*resupply*,  *•  resupply  a  vehicle*) 

GETDECIMAL  (Td  of  vehicle  to  resupply  from*) 

CALL  (vehicle_resupply) 

END_KEYWORD 

KEYWORD  (*show*,  *•  show  vehicle  status*) 

GETFELDS  (showjable) 

CALL  (show_vehicle) 

END_KEYW.«CPO 

KEYWORC  ('largeting*,  *•  adjust  targeting  parameters*) 

GETFIELDS  (firestatusjable) 

GETDECIMAL  (*Max  engagement  range*) 

CALL  (parser_set_targeting_parameters) 

END_KEYWORD 

END_KEYWORD_SEL£CT 

END  DEFINE  TABLE  _  _ 


Table  2.5-129;  DEFINE_TABLE  (vehiclejable) 


DEFINEJTABLE  (command_table) 

KEYWORD.SELECTf  Commands*) 

KEYWORD  Ccreate*,  *•  create  an  echelon*) 

GETFIELDS  (createjsidejable) 

GETSTRING  (*vehicle,  platoon,  company-reinforced,  etc.*) 
GETSTRING  (*tank,  motorized-rifle,  mechanized-infantry,  etc.*) 
GETDECIMAL  (*X  position*) 

GETDECIMAL  (*Y  positon*) 

GETSTRING  (Tormation*) 

GETDECIMAL  (*workstation  port  number  or  0*) 

CALL  (parser_create_vehicle) 

END_KEYWORD 


Table  2.5-130:  DEFINE_TABLE  (command_table)  Part  1  of  2 
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KEYWORD  fdebug*,  *•  debugging  operations*) 

GETFEUDS  (debu^ingjable) 

GET_ON_OR_OFF 
CALL  <toggle_debugging) 

END_KEYWORD 

KEYWORD  (•exit*.  *-  exit  program*) 

CALL  (saf_exit) 

END_KEYWORD 

KEYWORD  (*hashing*.  *-  simnet  id  hashing  statistics*) 
DO_KEYWORD_TABLE(hashingJable) 

END_KEYWORD 

KEYWORD  (*heap*,  *-  heap  operations*) 
DO_KEYWORD_TABLE(heapJable) 

END_KEYWORD 

KEYWORD  (*net*,  *-  network  commands*) 

DO_KEYWORD_TABLE  (netjable) 

END_KEYWORD 

KEYWORD  fprint*.  *-  print  commands*) 

DO_KEYWORD_TABLE  (printjabte) 

END_KEYWORD 

KEYWORD  fquit*,  *•  exit  program*) 

CALL  (saf_exit) 

END_KEYWORD 

KEYWORD  Creset*.  *-  global  phantom  reset ;  “USE  WITH  CAUTION***) 
DO_KEYWORD_TABLE  (parser_reset_table) 

END.KEYWORD 

KEYWORD  (*message*,  *•  send  a  message  to  the  Symbolics  screen*) 
GETSTRING  (*Messageto  send*) 

GETDECIMAL  (*Port  to  send  message  to*) 

CALL  (parser_send_string) 

END_KEYWORD 

KEYWORD  (*ser,  *-  set  program  parameters*) 

DO_KEYWORD_TABLE  (setjable) 

END_KEYWORD 

KEYWORD  fstealth*,  *-  stealth  operations*) 

DO_KEYWORD_TABLE  (steatthjable) 

END_KEYWORD 

KEYWORD  ("Vehicle*,  *-  vehicle  operations*) 

GETDECIMALCvehide  id*) 

DO_KEYWORD_TABLE  (vehidejable) 

END_KEYWORD 

END_KEYWORD_SELECT 
END  DEFINE  TABLE 


Table  2.5-130:  DEFINE_TABLE  (commandjable)  Part  2  of  2 
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2. 5. 2. 2  debug.h  CSU 
/simnet/sic/host/debug.h 

This  CSU  contains  the  bitfield  templates  for  activating  various  parts  of  the  debug^ng 
printouts  while  the  phantom  program  is  mnning.  In  a^ition  to  the  constant  definition 
tables,  the  CSU  contains  a  number  of  macros  that  are  defined  in  Appendix  A. 


Constant 

Value 

D  GLOBAL 

OxFFFFFFFF 

D  EVENT 

0x00000001 

D  OBSTACLE 

0x00000002 

D  COLLISION 

0x00000004 

D  GUNNER 

0x00000008 

D  DRIVER 

0x00000010 

D  PILOT  rAnaloaous to  DRIVER*/ 

0x00000010 

D  NAVIGATOR 

0x00000020 

D  INTERVIS 

0x00000040 

D  TURRET 

0x00000080 

D  WEAPON 

0x00000100 

D  STATION 

0x00000200 

D  VEHICLE 

0x00000400 

D  AIR 

0x00001000 

D  GROUND 

0x00002000 

D  COMPOSITE 

0x00008000 

D  TARGETING 

0x00040000 

D  TACTICAL 

0x00100000 

D  REMOTE 

0x00800000 

D  REPORTER 

0x01000000 

D  MISSILE 

0x02000000 

D  LOADER 

0x04000000 

D  CM 

0x08000000 

Table  2.5>131:  debug.h  Debugging  Constant  Definitions 
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Constant 

Valuo 

S  PILOT 

0x00000001 

S  NAVIGATOR 

0x00000002 

S  TARGETING 

0x00000004 

S  VEHICLE 

0x00000010 

S  AIR 

0x00000020 

S  FORMATION 

0x00000040 

S  REMOTE 

0x00000080 

S  INTERVIS 

0x00000100 

S  GUNNER 

0x00000200 

S  SAFVEH 

0x00000400 

S  WEAPON 

0x00000800 

S  COMPOSITE 

0x00001000 

S  STATE  UPDATE 

0x00002000 

S  ENTITY 

0x00004000 

S  TURRET 

0x00008000 

S  SAFENT 

0x00010000 

S  TACTICAL 

0x00200000 

S  REPORTER 

0x00800000 

S  DRIVER 

0x01000000 

S  SPOTTER 

0x02000000 

S  DETECTION 

0x04000000 

S  ALL 

OxFFFFFFFF 

S  DEFAULT 

0x00014412 

Table  2.5*132:  debug.h  Show  Constant  Definitions 
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2.6  LOCAL  VEHICLES  CSC 

The  local  vehicles  are  those  vehicles  which  are  simulated  by  the  SAP  Simhost  CSCI.  The 
Local  Vehicles  CSCI  includes  code  for  simulating  vehicle  maneuver,  for  determining  which 
enemy  vehicles  have  been  seen  and  detected,  for  assessing  damage  ftom  weapons,  for 
tracking  supply  consumption ,  and  for  performing  resupply  operations  Each  time  a  vehicle 
is  ticked  by  tiie  scheduler,  it  simulates  its  activities  during  the  interval  from  the  last  time  it 
ticked  to  the  current  time.  It  processes  the  packets  which  are  sent  to  it  (such  as  vehicle 
impact  packets).  It  also  generates  an  appearance  packet  which  is  sent  to  the  SIMNET 
int^ace.  The  packet  will  be  sent  out  on  the  SIMNET  LAN  if  the  state  of  the  vehicle  has 
changed  sufficiently  compared  to  the  state  of  the  vehicle’s  last  appearance  packet . 


Figure  2.6-1: 


Local  Vehicles  CSC  Structure 
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2.6.1  Local  Vehicles  Main  CSC 

The  Local  Vehicles  Main  CSC  [8.6.1]  consists  of  a  single  file,  the  saf_vehicle.c  CSC 
[8.6.1. 1].  The  structure  of  CSC  8.6.1  is  found  in  the  following  tables. 


Local  Vehides 
Main 
CSC 

8.6.1 


saf_vehicle.c 

CSC 

8.6.1.1 


saf_vehicle_calastrophic_killl  f  saf_vehiclejdrain_supplies 
_ CSU  8.6.1 .1.25 _ J  V  CSU  8.6.1.1.26 


saf_vehicle_sudden_stop 
CSU  8.6.1.1.27 


Figure  2.6-2:  Local  Vehicles  Main  CSC  Structure  Part  1  of  2 


198 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


^  safj 


I 


vehicle_next_event_ 
CSU  8.6.1.1.28 


n?\  ^  \ 

V  naedad  CSU  8.6.1.1.29  )  ^  provided  CSU  8.6.1.1.30  J 

L 


Csaf_v®hide^out_of  jgas  A  ^  saf_vehiclA_out_of_ammo  'N  r  saf_vehicle^fake_resupply'\ 
CSU  8.6.1.1.31  )  V  CSU  8.6.1.1.32  J  V  CSU  8  6.1 .1.33  J 

r 


(saf_vehicle_ganerate_statuS\  r ;af_vehjda_ramove_vahicle^  f  saf_vehicle_vehiclejmpact^ 
report  CSU  8.6.1.1.34  J  V  CSU  8.6.1.1.35  J  V  CSU  8.6.1. 1.36  J 

3 


r saf_vehicle_vehicle  rammed\  ^ 
V  CSU  8.6.1.1.37  J 

E 


- 

saf_vehide 
CSU  8.6 


i_mdirect_fire  A  ^ 
6.1.1.38  J 


n _ 

saf_vehicle_pro_sim 
CSU  8.6.1.1.39 


Csaf_vehicle_mission_  ^  f 
completed  CSU  8.6.1.1.40  J 


X 


saf_vehicle_useiess 
CSU  8.6.1.1.41 


Xsaf_vehicle_collision_overA 
CSU  8.6.1.1.42  J 


^af_vehicle_doing_collisionJ^  f  saf_vehicle_simulatorJn_  'S  ^  saf_vehicle_rejoin_unit  'N 
V  stuff  CSU  8.6.1.1.43  J  V  command  CSU  8.6.1.1.44  J  V  CSU  8.6.1.1.45  J 

:) 


^atj 


~-r - 

vahicia_execute_overlay 
CSU  8.6.1,1.46 


^  ^sa(j 


vehicle_cancei_overlay 
CSU  8.6.1.1.47 


DC 


saf_vehicle_set_route 
CSU  8.6.1.1.48 


c 


I 


saf_vehicle  $et_speed 
CSU  8.^1. 1.49 


J  C5 


I 


vehicle_set_direction 
CSU  8.6.1.1.50 


c 


X 


saf_vohicle_halt 

CSU  8.6.1.1.52 


Xsaf_vehicle_reset_station_'\ 
keeper  CSU  8.6.1.1.51 

L 


^  ^  saf_vehicle  change_speed'N  f  saf_vehicle_foltow_vehicle"N 
y  V  CSU  8.6.1.1.53  J  V  CSU  8.6 1.1.54  J 

I 


.  I - -  —  -  -  -  -  -  -  , _ 

Csat_vehicle_goto_point  A  ^ 5af_vehicle_resume_missior)\  r  saf_vehicle_face_directiorA 
CSU  8.6.1.1.55  J  V  CSU  8,6.1.1.56  J  C  CSU  8.6.1.1.57  J 


Csaf_vehicle_est _position  ^ 

CSU  8.6.1.1.58  J 

Figure  2.6-3:  Local  Vehicles  Main  CSC  Structure  Part  2  of  2 


2.6. 1.1  saf_vehicle.c  CSC 

/simnet/src;/host/saf_vehicle.c 

This  file  contains  the  CSUs  which  operate  on  all  saf  vehicles,  including  creation,  deletion, 
state  changes,  reporting,  resupply,  mission  and  immediate  commands. 
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2. 6. 1.1.1  create  saf  vehicle  CSU 


This  CSU  creates  a  SAF  vehicle. 


Parameters 


Parameters 


forcelD 


countrvD 


countrrvO 


tactics 


unit  type 


job 


battalion 


CO  moan 


latoon 


bumper 


headin 


i 

E 
E 
I? 
E 
E 


ForcelD 


unsigned  char 


unsigned  char 


unsigned  char 


inter  to  char 


inter  to  char 


unsigned  short 


unsigned  char 


unsigned  char 


unsigned  char 


REAL 


irs 

irs 


Where  Tvpedef  Declared 


basic.h 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


sim  tvpes.h 


sition 

PO 

inter  to  REAL  1 

1  sim  t 

ercent  ammo 


ercent  fuel 


pointer  to  Sec.  2A.3.3 

SBX  CONNECTION  VARS 


REAL  Sim  t 


REAL  Sim  t 


Return  Value 


safobi 


ReturnValues 


inter  to  SAF  OBJECT 


Meanln 


Vehicle  created. 


E 


E 


Function 


find  ta 


enerate  vehicle  id 


allocate  saf  vehicle 


deg  to  rad 


ft  float 


heap  allocate 


buffer  allocate 


et  me  a  random  fraction 


allocate  safobi 


create  tickable 


ft  int 


vec  CO 


create  vehicle 


et  guises 


saf  vehicle  set  markin 


init  gnd  entry  list 


create  damage 


create  turret 


IS  GROUNDVEH 


create  groundveh 


Calls 


Where  Described 


Sec.  2.1. 1.4.3 


Sec.  2.9.1. 2  See  Appendix  A 


sim  macros.h 


Sec.  2.14.1.2.12 


Sec.  2.14.2.1.1 


Sec.  2.14.4.2.12 


Sec.  2.14.3.7.1 


Sec.  2.2.2.2 


Sec.  2.2.3.1 


Sec.  2.14.1.2.11 


Sec.  2.9.2.1.1 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.9.2.2.1 


Sec.  2.6.1. 1.8 


Sec.  2.6.1. 1.9 


Sec.  2.9.3.1.11 


Sec.  2.6  2.1. 1 


Sec.  2.6.9.6.1 


Sec.  2.6.3.4.1 


Table  2.6-1  is  continued  on  the  following  page 
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Function 

Where  Described 

create  driver 

Sec.  2.6.3.2.1 

create  collision 

Sec.  2.6.3.1.1 

IS  HELI 

create  airveh 

Sec.  2.6.4.6.2 

create  pilot 

Sec.  2.6.4.2.2 

s  atan2 

IS  PLANE 

create  taraetinq 

Sec.  2.6.9.3.2 

create  weapon  systems 

Sec.  2.6.9.8.2 

create  loaistics 

Sec.  2.6.6.1.1 

create  detection 

Sec.  2.6.5.1.1 

sat  vehicle  teleport 

Sec.  2.6.1. 1.7 

Table  2.6-1:  create_saf_vehicle  CSU  [8.6.1.1.1] 


2. 6. 1.1. 2  saf_vehicIe_go_away  CSU 
This  CSU  makes  a  SAF  vehicle  go  away. 


1  Parameters  I 

Parameters 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF.OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

generate  a  deactivate 

Sec.  2.3.1. 1 

cancel  fnci  group 

Sec.  2.2.1. 1.5 

destroy  tickable 

Sec.  2.2.3.2 

Sec.  2.9.21. 2 

III  nil  III  II  ■III— 

Sec.  2.9.3.1.13 

destroy  vehicle 

Sec.  2.9.2.2.2 

destroy  damage 

Sec.  2.6.21. 2 

destroy  turret 

Sec.  2.6  9.6.2 

destroy  groundveh 

Sec.  2.6.3.4.2 

destroy  airveh 

Sec.  2.6.4.6.3 

destroy  driver 

Sec.  2.6.3.2.2 

destroy  collision 

Sec.  2.6.3. 1.2 

destroy  pilot 

Sec.  2.6  4.2.4 

destroy  targeting 

Sec.  2.6  9.3.3 

destroy  weapon  systems 

Sec.  2.6.9.8  3 

destroy  logistics 

Sec.  2.6.6.1.2 

destroy  detection 

Sec.  2.6.5.1.3 

buffer  deallocate 

Sec.  2.14.4.2.15 

deallocate  saf  vehicle 

Sec.  2.9.1. 2  See  Appendix  A 

deallocate  safobi 

Sec.  2.2.2.3 

unhash  saf  id 

Table  2.6-2:  saf_vehicle_go_away  CSU  [8.6.1. 1.2] 
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2. 6. 1.1. 3  saf_vehicle_start_ticking  CSU 

This  CSU  starts  a  timer. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

start  ticking 

Sec.  2.2.3.3 

Table  2.6-3:  saf_vehicle_start_ticking  CSU  [8.6.1.1.3] 


2. 6. 1.1. 4  saf_vehicle_set_superior  CSU 


This  CSU  designates  the  superior  vehicle. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

*superior 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described  1 

DEBUG  COMPOSITE 

OBJ  VEHICLEID 

composite_removeJnferior_ 

vehicle 

Sec.  2.8.1. 3.8 

composite_addJnferior_ 

vehicle 

Sec.  2.8.1. 3.7 

Table  2.6-4:  saf_vehicle_set_superior  CSU  [8.6.1. 1.4] 


2. 6. 1.1. 5  saf_vehicle_set_leader  CSU 
This  CSU  designates  the  leader. 


Parameters 


safobi 


id 


xoff 


off 


unit  lead  id 


unit  xoff 


unit  voff 


•orderer 


Parameters 


inter  to  SAF  OBJECT 


unsioned  int 


int 


int 


unsioned  int 


int 


int 


inter  to  SAF  OBJECT 


Where  Tyoedef  Declared 


Sec.  2.9.1. 1 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Sec.  2.9.1. 1 
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1  Calls  1 

Function 

Where  Described  1 

DEBUG  VEHICLE 

OBJ  VEHICLEID 

driver  set  leader  mis 

Sec.  2.6.3.2.18 

driver  follow  leader 

Sec.  2.6.3.2.19 

pilot  set  leader  mis 

Sec.  2.6.4.2.79 

pilot  follow  leader 

Sec.  2.6.4.2.80 

Table  2.6-5; 

saf_vehicle__scMeader  CSU  [8.6.1. 1.5] 

2. 6. 1.1. 6  saf_vehicle_teleport_to_station  CSU 

1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

mission  stationpoint 

Sec.  2.6.3  2.9 

pilot  stationpoint 

Sec.  2.6.4.2.78 

saf  vehicle  teleport 

Sec.  2.6.1. 1.7 

Table  2.6-6;  saf_vehicle_teIeport_to_station  CSU  [8.6.1. 1.6] 


2. 6. 1.1. 7  saf_vehicle_teleport  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

X 

REAL 

Sim  tvpes.h 

1 

REAL 

sim types.h 

1  Calls  1 

Function 

Where  Described  I 

s  atan2 

coords  within  database 

tdb  place  vehicle 

Sec.  2.21.7.20.5 

report  error  from  tdb  once 

Sec.  2.14.1.2.4 

mat  rot  init 

Sec.  2.6.2.47.1  Vehicles  CSCI  SDD 

update  arid  entry  list 

Sec.  2.9.3.1.12 

Table  2.6-7;  saf_vehicle_teleport  CSU  [8.6.1. 1.7] 
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2. 6. 1.1. 8  get_guises  CSU 


This  CSU  determines  the  vehicle  guises. 


1  Parameters  1 

Parameters 

Typo 

Where  Typedef  Declared 

•table 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

distinguished  county 

unsigned  short 

Standard 

other  country 

unsigned  short 

Standard 

•guises 

pointer  to  VehicleGuises 

basic.h 

Calls 

Function 

Where  Described 

ft  int 

Sec.  2.14.1.2.11 

Table  2.6-8:  get_guises  CSU  [8.6.1. 1.8] 
2.6. 1.1.9  saf_vehlcle_set_marking  CSU 


This  CSU  sets  the  vehicle  markings. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

battalion 

unsigned  short 

Standard 

unsigned  char 

Standard 

platoon 

unsigned  char 

Standard 

bumper 

int 

Standard 

Table  2.6-9:  saf_vehicle_set_marking  CSU  [8.6.1. 1.9] 


2.6.1.1.10  vehicle_status_string  CSU 


Within  this  CSU,  the  macro  ADD_STRING(s,p,b)  is  defined.  The  definition  is  included 
in  Appendix  A. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

status 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

but 

pointer  to  char 

Text  to  be  displayed. 

Table  2.6-10:  vehicle_status_string  CSU  [8.6.1.1.10] 
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2.6.1.1.11  saf  vehicle  show  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

flaos 

int 

Standard 

I  Calls  1 

Function 

Where  Described 

entity  show 

Sec.  2.9.2.1.4 

vehicle  show 

Sec.  2.9  2.2.4 

driver  show 

Sec.  2.6.3.2.43 

collision  show 

Sec.  2.6.3.1.4 

airveh  show 

Sec.  2.6.4.6.4 

pilot  show 

Sec.  2.6.4.2.7 

turret  show 

Sec.  2.6.9.6.3 

taroetino  show 

Sec.  2.6.9.3.5 

detection  show 

Sec.  2.6.5.1.5 

weapon  systems  show 

Sec.  2.6.9.8.5 

OBJ  VEHICLEID 

vehicle  status_strina 

Sec.  2.6.1.1.10  1 

Table  2.6-11:  saf_vehicle_show  CSU  [8.6.1.1.11] 


2.6.1.1.12  saf_vehicle_set_targeting_parameters  CSU 
This  CSU  sets  the  targiting  parameters. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

tirestatus 

int 

Standard 

max  enaaaement  ranoe 

REAL 

Sim  types. h 

marksmanship 

REAL 

Sim  types.h 

position  X 

REAL 

Sim  tvpes.h 

position  V 

REAL 

Sim  types.h 

radius 

REAL 

Sim  types.h 

taroetsf  1 

unsigned  short 

Standard 

Calls 


Function 

Where  Described 

taroetino  set  parameters 

Sec.  2.6.9.3.11 

Table  2.6-12:  saf_vehicle_set_targeting_parameters  CSU  [8.6.1.1.12] 
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2.6.1.1.13  saf_vehicle_filMn_appearance_data  CSU 
This  CSU  fills  in  the  appearance  data  for  a  vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*desc_ptr 

pointer  to 

VEHICLE  APPEARANCE 
DESCRIPTOR 

Sec.  2.4.1. 1 

Calls 

Function 

Where  Described 

entity_filljn_appearance_ 

data 

Sec.  2.9.2.1.6 

vehicle_filljn_appearance_ 

data 

Sec.  2.9.2.2.6 

Table  2.6-13:  saf_vehicle_filMn_appearance_data  CSU  [8.6.1.1.13] 


2.6.1.1.14  saf_vehicle_fill_in_echelon_data  CSU 
This  CSU  fills  in  the  vehicle  echelon  data. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘safobi 

pointer  to  SAF  OBJECT 

Sec.  2. 9. 1.1 

•descjDtr 

pointer  to 

VEHICLE  ECHELON 
DESCRIPTOR 

Sec.  2.4.1. 1 

1  Calls  1 

Function 

Where  Described  I 

OBJ  VEHICLEID 

Table  2.6-14:  saf_vehicle_fiII_in_echelon_data  CSU  [8.6.1.1.14] 


2.6.1.1.15  saf_vehicle_filMn_position_data  CSU 


This  CSU  fills  in  the  vehicle  position  data. 


1  Parameters  i 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*desc_ptr 

pointer  to 

VEHICLE  POSITION 
DESCRIPTOR 

Sec.  2.4.1. 1 
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_ _ Calls 

Function _ Where  Described 

entity  fill  in  position  data  Sec.  2.9.2. 1.5 
vehicle  fill  in  position,  data  Sec.  2.9.2.2.S 


Table  2.6-15:  saf_vehicle_fill_in_position_data  CSU  [8.6.1.1.15] 


2.6.1.1.16  saf_vehicle_checkpoint_state  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

port  number 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

OBJ  VEHICLEID 

weapon  systems  checkpoint 

Sec.  2.6.9.8.9 

sbx_connection_sendjo_ 

port 

Sec.  2.4.3.2.19 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.6-16:  saf_vehicle_checkpoint_state  CSU  [8.6.1.1.16] 


2.6.1.1.17  saf_vehicle_remit  CSU 
This  CSU  reinitializes  a  SAP  vehicle. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

loads!  1 

short 

Standard 

fuel 

int 

Standard 

status 

char 

Standard 

X 

REAL 

Sim  types.h 

y 

REAL 

Sim  types.h 

bearino 

REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

weapon  systems  reinit 

Sec.  2.6.9.8.10 

saf  vehicle  catastrophic  kill 

Sec.  2.6.1.1.25 

saf  vehicle  mobility  kill 

Sec.  2.6.1.1.23 

saf  vehicle  firepower  kill 

Sec.  2.6.1.1.22 

Table  2.6-17:  saf_vehicle_reinit  CSU  [8.6.1.1.17] 
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2.6.1.1.18  saf_vehicle_mimic_vehicle  CSU 
This  CSU  causes  a  vehicle  to  mimic  another  vehicle. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

vid 

unsianed  int 

Standard 

1  Calls  1 

Function 

Where  Described 

simnet  send  deactivate 

OBJ  VEHICLEID 

1  IT  II  ■ 

RETYPE  VEHICLE 

Table  2.6*18:  saf_vehicle_inimic_vehicle  CSU  [8.6.1.1.18] 


2.6.1.1.19  saf_vehicle_stop_mimicing  CSU 


This  CSU  causes  a  vehicle  to  stop  mimicing 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

REAL 

mil  IB 

I  Calls  I 

Function 

Where  Described 

vec  COPY 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

RETYPE  VEHICLE 

OBJ  VEHICLEID 

Table  2.6-19;  saf_vehicle_stop_mimicing  CSU  [8.6.1.1.19] 

2.6.1.1.20  saf_vehicle_ 

tick  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 
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Calls 

Function 

Where  Described 

tickable  note  start  tick 

Sec.  2.2.3.6 

chanae  tick  rate 

Sec.  2.2.3.5 

vec  CO 


LOOKUP  VEHICLE 


OBJ  POSITION 


OBJ  VELOCITY 


OBJ  HULL  TO  WORLD 


OBJ  DIRECTION 


roundveh  tick 


air  tick 


saf_vehicle_send_ 
arance 


ate  and  entry  list 


buffer  simole  dequeue 


buffer  deallocate 


sat  vehicle  oro  sim 


unner  round  fivin 


tarqetina  tick 


collision  tick 


driver  tick 


ilot  tick 


coiiision  dead  tick 


loqistics  tick 


max 


saf  vehicle  out  of  oas 


Sec.  2.6.2.59.1  Vehicles  CSCI  SOD 


ndix  A 


ndix  A 


ndix  A 


ndix  A 


ndix  A 


Sec.  2.6.3.4.4 


Sec.  2.6.4.6  5 


Sec.  2.6.1.1.21 


Sec.  2.9.3.1.12 


Sec.  2.14.4.1.15 


Sec.  2.14.4.2.15 


Sec.  2.6.1.1.39 


Sec.  2.6  9.5.6 


Sec.  2.6.9.3.21 


Sec.  2.6.3.1.6 


Sec.  2.6.3.2.4 


Sec.  2.6.4.2.64 


Sec.  2.6.3.1.7 


Sec.  2.6.6.1.10 


Sec.  2.13.3.5  &  Sec.  2  6.7.3  See . 


Sec.  2.6.1.1.31 


ndix  A 


Table  2.6-20:  saf  vehicle  tick  CSU  [8.6.1.1.20] 


2.6.1.1.21  saf_vehicie_send_appearance  CSU 


This  CSU  sends  an  apOpearance  packet  over  the  network. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobl 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

simnet  send  appearance 

Table  2.6-21:  saf_vehicle_send_appearance  CSU  [8.6.1.1.21] 
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2.6.1.1.22  saf_vehicle_firepower_kill 


CSU 


This  CSU  kills  a  vehicle’s  firepower. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

broadcast  aooearance  data 

Sec.  2.4.3.2.73 

turret  firepower  kill 

Sec.  2.6.9.6.10 

Table  2.6*22:  saf_vehicle_firepower_kill  CSU  [8.6.1.1.22] 


2.6.1.1.23  saf_vehicle_mobility_kiil  CSU 
This  CSU  renders  a  vehicle  imobile. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

groundveh  mobility  kill 

Sec.  2.6.3.4.5 

saf  vehicle  catastrophic  kill 

Sec.  2.6.1.1.25 

broadcast  appearance  data 

Sec.  2.4.3.2.73 

composite  note  leader  state 

Sec.  2.8.1.3.36 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-23: 

saf_vehicle_mobility_kill 

CSU  [8.6.1.1.23] 

2.6.1.1.24  saf__vehlcle_stop_flaming  CSU 

This  CSU  causes  the  vehicle  to  stop  burning. 

1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Table  2.6-24:  saf_vehicle_stop_flaming  CSU  [8.6.1.1.24] 
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2.6.1.1.25  saf_vehicle_catastrophic_fcill  CSU 
This  CSU  destroys  a  vehicle. 


Parameters 


Parameters 


*safobi 


im. 


pointer  to  SAP  OBJECT 


Where  Typedef  Declared 


Sec.  2.9.1 .1 


Calls 


Function 


groundveh  mobility  kill 


deferred  fnci 


aifveh  catastrophic  kill 


broadcast  appearance  data 


composite  note  leader  state 


compositeJnferior_changed_ 
status _ 


composite_note_member_ 
vehicle  has  died 


Where  Described 


Sec.  2.6.3.4.5 


Sec.  2.2.1. 1.1 


Sec.  2.6.4.6.7 


Sec.  2.4.3.2.73 


Sec.  2.8.1.3.36 


Sec.  2.8.1.3.37 


Sec.  2.8.1.3.38 


Table  2.6-25:  saf_vehicle_catastrophic_kill  CSU  [8.6.1.1.25] 

2.6.1.1.26  saf_vehicle_drain_supplies  CSU 
This  CSU  decrements  the  vehicle’s  supplies. 


i  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

Table  2.6-26:  saf_vehicle_drain_suppHes  CSU  [8.6.1.1.26] 

2.6.1.1.27  saf_vehicle_sudden_stop  CSU 
This  CSU  causes  a  vehicle  to  stop  suddenly. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Table  2.6-27:  saf_vehicle_sudden_stop  CSU  [8.6.1.1.27] 


2.6.1.1.28  saf_vehicle_next_event_id  CSU 
This  CSU  returns  the  id  for  the  next  event 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 
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1  ReturnVaiues  1 

Return  Value 

Type 

Meanina 

safobj->vehicle->network_ 

event 

int 

Next  event  id. 

Table  2.6-28:  saf_vehicie_next_evenMd  CSU  [8.6.1.1.28] 


2.6.1.1.29  saf_vehicle_supplies_needed  CSU 
This  CSU  determines  if  a  vehicle  is  out  of  fuel. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*8afobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

•num  ptr 

pointer  to  int 

Standard 

*sup  ptr 

pointer  to  MunitionOuantity 

basic,  h 

Table  2.6-29:  saf_vehicle_supplies_needed  CSU  [8.6.1.1.29] 


2.6.1.1.30  saf_vehicle_supplies_provided  CSU 


This  CSU  resupplies  a  vehicle. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

num 

int 

Standard 

pointer  to  MunitionOuantity 

basic.h 

1  Calls  1 

Function 

Where  Described 

composite  note  leader,  state 

Sec.  2.8.1.3.36 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-30:  saf_vehicle_supplies_provided  CSU  [8.6.1.1.30] 


2.6.1.1.31  saf_vehicle_out_of_gas  CSU 
This  CSU  causes  a  vehixle  to  run  out  of  gas. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9. 1.1 
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1  Calls  1 

Function 

Where  Described  1 

DEBUG  VEHICLE 

1  1 1  II  ■ 

composite  note  leader  state 

Sec.  2.8.1.3.36 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6>31:  saf__vehicle_out_of_gas  CSU  [8.6.1.1.31] 


2.6.1.1.32  saf_vehicle__out_of_ammo  CSU 
This  CSU  causes  a  vehicle  to  run  out  of  ammunition. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described  1 

DEBUG  VEHICLE 

Table  2.6>32:  saf_vehicle_out_of_ammo  CSU  [8.6.1.1.32] 


2.6.1.1.33 


saf_vehicle_fake_resupply  CSU 


This  CSU  fakes  a  vehicle  resupply. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

compositeJnferior_changed_ 
status  ^ 

Sec.  ?  8.1.3.37 

DEBUG  VEHICLE 

weapon  systems  rearm 

Sec.  2.6.9.8.8  1 

Table  2.6*33:  saf_vehicle_fake_resupply  CSU  [8.6.1.1.33] 


2.6.1.1.34  saf_vehicle_generate_status__report  CSU 
This  CSU  prints  out  a  status  report  about  a  SAF  vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 
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1  Calls  1 

Function 

Where  Described 

buffer  allocate 

Sec.  2.14.4.2.12 

vec  maaS 

Sim  macros.h 

OBJ  VELOCITY 

Sec.  2.9. 1.1  See  Appendix  A 

OBJ  POSITION 

Sec.  2.9. 1.1  See  Appendix  A 

Sec.  2.21.7.24.3 

LOOKUP  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

sbx  printf 

Sec.  2.4.3.2.8 

OBJ  VEHICLEID 

Sec.  2.9. 1.1  See  Appendix  A 

OBJ  OWNER  PORT  NUMB 
ER 

Sec.  2.9.1. 1  See  Appendix  A 

clear  weapons  status 

Sec.  2.6.9.8.11 

add  weapons  status 

Sec.  2.6.9.8.12 

fill  sbx  opfor  header 

Sec.  2.4.3.2.18 

driver_executing_immediate_ 

command 

Sec.  2.6.3.2.15 

pilot_executingJmmediate_ 

command 

Sec.  2.6.4.2.72 

mps  to  kph 

Sec.  2.13.3.1  See  Appendix  A 

mps  to  knots 

Sec.  2.13.3.1  See  Appendix  A 

vehicle  status  strina 

Sec.  2.6.1.1.10 

sbx_connection_send_to_ 

port 

Sec.  2.4.3.2.19 

buffer  deallocate 

Sec.  2.14.4.2.15 

Table  2.6-34:  saf_vehicle_generate_status_report  CSU  [8.6.1.1.34] 


2.6.1.1.35  saf_vehicle_remove_vehicIes  CSU 

This  CSU  removes  the  designated  number  of  vehicles  from  the  active  list. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

num 

int 

Standard 

v  listfl 

unsigned  int 

Standard 

1  Calls  1 

Function 

Where  Described 

driver  remove  vehicles 

Sec.  2.6.3  2.3 

pilot  remove  vehicles 

Sec.  2.6.4.2.5 

collision  remove  vehicles 

Sec.  2.6.3. 1.3 

lOQistics  remove  vehicles 

Sec.  2.6.6.1.3 

detection  remove  vehicles 

Sec.  2.6.5. 1.4 

Table  2.6-35;  saf_vehicle_remove_vehicles  CSU  [8.6.1.1.351 
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2.6.1.1.36  saf_vehicle_vehicle_impact  CSU 


This  CSU  causes  a  vehicle  to  be  impacted  by  a  round. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

*spdu 

pointer  to  SimulationPDU 

p  sim.h 

1  Calls  1 

Function 

Where  Described 

damaae  vehicle  impact 

Sec.  2.6.2.1.4 

Table  2.6-36:  saf_vehicle_vehicle_impact  CSU  [8.6.1.1.36] 


2.6.1.1.37  saf_vehicle_vehicle_ramined  CSU 
This  CSU  causes  two  vehicles  to  collide. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*spdu 

pointer  to  SimulationPDU 

p  sim.h 

1  Calls  1 

Function 

Where  Described 

damage  vehicle  rammed 

Sec.  2.6.2.1.5 

collision  vehicle  rammed 

Sec.  2.6.3.1.12 

Table  2.6-37:  saf_vehicle_vehicle_rammed  CSU  [8.6.1.1.37] 


2.6.1.1.38  saf_vehicle_indirect_fire  CSU 


This  CSU  causes  a  vehicle  to  be  hit  by  indirect  fire. 


1  Parameters 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*spdu 

pointer  to  SimulationPDU 

p  sim.h 

1  Calls  1 

Function 

Where  Described 

damage  indirect  fire 

Sec.  2.6.21. 6 

Table  2.6-38:  saf_vehicle_indlrect_nre  CSU  [8.6.1.1.38] 
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2.6.1.1.39  saf_vehicle_pro_sim  CSU 
This  CSU  generates  protocol  data  units. 


Parameters 


Parameters 


*safobi 


inter  to  SAP  OBJECT 


inter  to  SimulationPDU 


1 1? 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


sim.h 


Error  Name 


Bad  packet  t 


Errors 


Reason  for  Error 


Unknown  packet  tvpe. 


Calls 

Function 

Where  Described 

saf  vehicle  vehicle  impact 

Sec.  2.6.1.1.36 

saf  vehicle  indirect  fire 

Sec.  2.6.1.1.38 

saf  vehicle  vehicle  rammed 

Sec.  2.6.1.1.37 

logistics_supply_offer_ 

received 

Sec.  2.6.6.1.9 

logistics_supply_offer_ 

canceled 

Sec.  2.6.6. 1.8 

ERROR  OUT 

endix  A 

OBJ  VEHICLEID 

endix  A 

Table  2.6-39:  saf_vehlcle_pro_sim  CSU  [8.6.1.1.39] 

2.6.1.1.40  saf_vehicle_mission_coinpleted  CSU 
This  CSU  sets  the  status  of  a  mission  to  be  complete. 


Parameters 


safobi 


Return  Value 


dnver  mission  completed 


ilot  mission  completed 


TRUE 


IDTt 


Parameters 


inter  to  SAP  OBJECT 


ReturnValues 


Where  Typedef  Declared 


Sec.  2.9. 1.1 


iMmnr 


Response  if  driver. 


Response  if  pilot. 


Mission  completed. 


Calls 

Punctlon 

Where  Described 

driver  mission  completed 

Sec.  2.6.3.2.16 

ilot  mission  completed 


Sec.  2.6.4.2.77 


Table  2.6-40:  saf_  vehicle  inis.sion_completed  CSU  [8.6.1.1.40] 
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2.6.1.1.41  saf_vehicle_useless  CSV 

This  CSU  returns  TRUE  if  a  vehicle  is  unavailable  and  returns  FALSE  if  it  is  available. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*safobi 

DOinter  to  SAF.OBJECT 

Sec.  2.9.1. 1 

*whos  askina 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

ReturnValues 

Return  Value 

Type 

Meaning 

TRUE 

int 

Vehicle  is  not  available  for  use. 

FALSE 

int 

Vehicle  is  available  for  use. 

(saf_vehicle->superior  !> 
whos.asking)  &&  composite. 
executing_order(saf_ 
vehicle->suDerior) 

int 

Vehicle  is  not  available  if  it  is 
not  the  company  asking  and 
the  platoon  is  busy. 

Calls 

Function 

Where  Described 

driver_executing_immediate_ 

command 

Sec.  2.6.3.2.15 

pilot_executing_immediate_ 

command 

Sec.  2.6.4.2.72 

composite  executing  order 

Sec.  2.8.1.3.35 

Table  2.6*41:  $af_vehicle_useless  CSU  [8.6.1.1.41] 


2.6.1.1.42  saf_vehicIe_colUsion_over  CSU 
This  CSU  ends  a  collision. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*box 

pointer  to  RECT 

Sec.  2. 

1  Calls  1 

Function 

Where  Described 

driver  resume  from  collision 

Sec.  2.6.3.2.26 

Table  2.6-42:  saf_vehicle_collision_over  CSU  [8.6.1.1.42] 


2.6.1.1.43  saf_vehicle_doing_collision_stuff  CSU 


This  CSU  disengages  a  vehicle  from  a  collision. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 
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Table  2.6-43:  saf_vehicie_doing_collision_stuff  CSU  [8.6.1.1.43] 


2.6.1.1.44  saf  vehicle  simulator  in  command  CSU 


Parameters 


safobi 


irs 


Parameters 


inter  to  SAF  OBJECT 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Return  Value  I  Type 


(saf_object->driver  &&  driver_  int 
simulator  in  command!... I 


ReturnValues 


Calls 


Function  Where  Described 


dnver  simulator  in  command  Sec.  2.6.3.2.12 


Table  2.6-44:  saf_vehicie_simuiator_in_command  CSU  [8.6.1.1.44] 

2.6.1.1.45  saf_vehicle_rejoin_unit  CSU 
This  CSU  causes  a  vehicle  to  rejoin  its  unit 


Parameters 


Parameters 


inter  to  SAF  OBJECT 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Calls 


Function  Where  Described 


saf  vehicle  cancel  overlay  I  Sec.  2.6.1.1.47 


Table  2.6-45:  saf_vehicle_rejoin_unit  CSU  [8.6.1.1.45] 
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2.6.1.1.46  saf_vehicle_execute_overlay  CSU 
This  CSU  causes  a  vehicle  to  execute  the  designated  overlay. 


Parameters 


safobi 


Parameters 


inter  to  SAP  OBJECT 


inter  to  OVERLAY 


pointer  to 

CONTROL  MEASURE 


Where  Typedef  Declared 


Sec.  2.9. 1.1 


Sec.  2.10.2.2 


Sec.  2.10.2.2 


Calls 


Function  Where  Described 


composite  note  leader  state  Sec.  2.8.1.3.36 


driver  execute  overlay  I  Sec.  2.6.3.2.17 


Sec.  2.6.4.2.85 


compositeJnferior_changed_  Sec.  2.8.1.3.37 
status 


Table  2.6-46:  saf_vehicIe_execute_overIay  CSU  [8.6.1.1.46] 


2.6.1.1.47  saf_vehicle_cancel_overIay  CSU 


This  CSU  cancels  an  overlay. 


Parameters 


safobi 


IBT? 


Parameters 


inter  to  SAP  OBJECT 


Where  Typedef  Declared 


Sec.  2.9. 1.1 


Calls 


Function  Where  Described 


composite  note  leader  state  Sec.  2.8.1.3.36 


driver  stop  mission  Sec.  2.6.3.2.20 


ilot  stop  mission  Sec.  2.6.4.2.82 


compositejnferior_changed_  Sec.  2.8.1.3.37 
status 


Table  2.6-47;  saf_vehicle_canceI_overlay  CSU  [8.6.1.1.47] 


2.6.1.1.48  saf_vehicle_set_route  CSU 
This  CSU  sets  the  route  for  the  vehicles  to  follow. 


Parameters 


*safobi 


•route 


routepoint 


orderer 


Parameters 


inter  to  SAP  OBJECT 


inter  to  ROUTE 


inter  to  ROUTEPOINT 


inter  to  SAP  OBJECT 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.10.2.5 


Sec.  2.10.2.5 


Sec.  2.9.1. 1 
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1  Errors  I 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

No  pilot  or  driver  for  vehicle. 

Calls 

Function 

Where  Described 

driver  set  route 

Sec.  2.6.3.2.22 

pilot_set  route 

Sec.  2.6.4.2.81 

Table  2.6-48:  saf_vehicle_set_route  CSU  [8.6.1.1.48] 


2.6.1.1.49  saf_vehicle_set_speed  CSV 


This  CSU  sets  the  vehicle  speed. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

speed 

REAL 

Sim  types. h 

1  ReturnVaiues  1 

Return  Value 

Type 

Meanina 

driver  set  speed 

int 

Speed  set  by  driver. 

pilot  set  speed 

int 

FALSE 

int 

There  is  no  driver  or  pilot.  I 

1  Calls  1 

Function 

Where  Described 

driver  set  speed 

Sec.  2.6.3.2.23 

pilot  set  speed 

Sec.  2.6.4.2.83 

Table  2.6-49: 

saf_vehicle_set_speed  CSU  [8.6.1.1.49] 

2.6.1.1.50  saf_vehicle_set_direction  CSU 

This  CSU  sets  the  vehicle  direction. 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

direction 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

driver  set  direction 

Sec.  2.6.3.2.24 

Table  2.6-50: 

saf_vehicle_set_direction 

CSU  [8.6.1.1.501 

220 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2.6.1.1.51  saf_vehicle_reset_station_keeper  CSU 


This  CSU  resets  the  station  keeper. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

Calls 

Function 

Where  Described 

driver  foraet  about  forps 

Sec.  2.6.3.2.21 

p  follower  set  follow 

Sec.  2.6.4.3.10 

Table  2.6>51:  saf_vehicle_reset_station_keeper  CSU  [8.6.1.1.51] 


2.6.1.1.52  saf_vehicle_ 

halt  CSU 

This  CSU  causes  a  vehicle  to  stop. 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

driver  halt  cmd 

Sec.  2.6.3.2.27 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-52:  saf_vehicle_halt  CSU  [8.6.1.1.52] 


2.6.1.1.53  saf_vehicle_change_speed  CSU 


This  CSU  changes  the  speed  of  a  vehicle. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

'safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

speed 

REAL 

Sim  types.h 

*orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

driver  change  speed  cmd 

Sec.  2.6.3.2.33 

pilot  change  speed  im 

Sec.  2.6.4.2.68 

Table  2.6-53:  saf_vehicle_change_speed  CSU  [8.6.1.1.53] 
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2.6.1.1.54  saf_vehicle_follow_vehicle  CSU 
This  CSU  causes  a  vehicle  to  follow  a  designated  vehicle. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

vid 

unsianed  int 

Standard 

xoff 

int 

Standard 

voff 

int 

Standard 

•orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

driver  follow  vehicle  cmd 

Sec.  2.6.3.2.28 

pilot  follow  vehicle  im 

Sec.  2.6.4.2.73 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-54:  saf_vehicle_follow_vehicIe  CSU  [8.6.1.1.54] 


2.6.1.1.55  saf_vehicle_goto_point  CSU 


This  CSU  causes  a  vehicle  to  go  to  a  designated  point. 


1  Parameters  1 

Parameters 

Type 

Where  Tyoedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

X 

REAL 

Sim  types.h 

y 

REAL 

Sim  types.h 

backwardp 

int 

Standard 

•orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  :: 

i  Calls 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

driver  ooto  point  cmd 

Sec.  2.6.3.2.29 

pilot  QOto  point  im 

Sec.  2.6.4.2.69 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-55:  saf_vehicle_goto_point  CSU  [8.6.1.1.55] 
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2.6.1.1.56  saf_vehicie_resume_inission  CSU 
This  CSU  causes  a  mission  to  be  resumed. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

‘orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

Calls 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

driver  resume  mission  cmd 

Sec.  2.6.3.2.31 

pilot  cancel  immediate 

Sec.  6.4.2.71 

compositeJnferlor_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-56:  saf_vehicIe_resume_mission  CSU  [8.6.1.1.56] 


2.6.1.1.57  saf_vehicle_face_direction  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

mathradians 

REAL 

Sim  tvpes.h 

‘orderer 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

composite  note  leader  state 

Sec.  2.8.1.3.36 

driver  face  direction  cmd 

Sec.  2.6.3.2.30 

pilot  face  direction  im 

Sec.  6.4.2.74 

compositeJnferior_changed_ 

status 

Sec.  2.8.1.3.37 

Table  2.6-57:  saf_vehicle_face_direction  CSU  [8.6.1.1.57] 


2.6.1.1.58  saf_vehicle_est_positlon  CSU 
This  CSU  estimates  vehicle  location  when  time  occurs. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

time 

unsiqned 

Standard 

location 

VECTOR 

Sim  tvpes.h 

BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


Function 


vec  scale 


OBJ  VELOCITY 


vec  add 


OBJ  POSITION 


Calls 


Where  Described 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


endix  A 


Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 


endix  A 


Table  2.6-58:  saf_vehicle_est_position  CSU  [8.6.1.1.58] 


2.6.2  Damage  CSC 

The  Damage  CSC  [8.6.2]  consists  of  a  single  file,  the  damage.c  CSC  [8.6.2.!].  The 
structure  of  CSC  8.6.2  is  found  in  the  following  table. 


2.6.2. 1  damage.c  CSC 

/simnet/src/host/damage.c 

This  CSC  contains  the  code  which  handles  the  damage  calculations  for  vehicles. 

The  square  of  the  maximum  damage  range  is  defined  as  a  constant  of  4900  (#definc 
MAX_DAMAGE_RANGE2  4900  I*  70  meters  ♦/). 
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2.6.2. 1.1  create_dainage  CSU 


This  CSU  creates  damage. 


i 


Parameters 


id 


table 


Parameters 


unsianed  int 


intertoOATA  UNION 


irs 


Where  Typedef  Declared 


Standard 


Sec.  2. 1.1. 5 


Return  Value 


damaae 


\n 


ReturnVaiues 


Meanin 


inter  to  DAMAGE  VARS  Damaae  aeated. 


Function 


allocate  damaae 


ft  symbol 


find  ta 


ft  float 


Calls 


Where  Described 


Sec.  2.14.1.2.13 


Sec.  2.1. 1.4.3 


Sec.  2.14.1.2.12 


endix  A 


Table  2.6-59:  create_daniage  CSU  [8.6.2.1.1] 


2.6.2. 1.2  destroy_damage  CSU 


This  CSU  calls  deallocate.damage. 


Parameters 


damaae 


Function 


deallocate  damaae 


lEIT^ 

irs 


Parameters 


e  Where  Typedef  Declared 


inter  to  DAMAGE  VARS  I  Sec.  2. 


Calls 


Where  Described 


endix  A 


Table  2.6-60:  destroy _damage  CSU  [8.6.2.1.2] 

2.6.2. 1.3  dainage_string  CSU 

This  CSU  returns  a  stnng  which  describes  the  damage  sustained  by  a  vehicle. 
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ReturnValues 


Return  Value 


no  damaae” 


"catastroDhic  damaae* 


mobility  damaae* 


"fireoower  damaae* 


unknown  damaae* 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


Meanin 


No  damaae. 


Catastrophic  damage. 


Mobility  damaae. 


Fireoower  damaae. 


Damaae  unknown. 


Table  2.6-61:  dainage_string  CSU  [8.6.2.1.3] 


2. 6. 2. 1.4  damage_vehicle_impact  CSU 

This  CSU  determines  the  damage  to  a  vehicle  caused  by  an  impact 


Parameters 


safobi 


*SDdu 


I  DTI! 

irs 
irs 


Parameters 


inter  to  SAF  OBJECT 


inter  to  SimuiationPDU 


IIT 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


sim.h 


Function 


et  me  a  random  fraction 


saf  id  from  simnet  id 


redicate  impact  hook 


database  df  damaae  cue 


DEBUG  VEHICLE 


damaae  stiin 


IS  HELI 


IS  PLANE 


saf  vehicle  catastrophic  kill 


simnet  send  status  chanae 


saf  vehicle  mobility  kill 


saf  vehicle  firepower  kill 


Calls 


Where  Described 


Sec.  2.14.3.7.1 _ 


Sec.  2.10.1.3.7 


Sec.  2.6.8.6.10 


Sec.  2.5.2.2  See  Appendix  A 


Sec.  2  6.2.1. 3 


Sec.  2.6.1.1.23 


Sec.  2.6.1.1.22 


Table  2.6-62:  damage_vehicle_impact  CSU  [8.6.2.1.4] 


2.6.2. 1.5  damage_vehicle_rammed  CSU 


This  CSU  determines  the  dammage  to  a  vehir'e  that  was  involved  in  a  collision. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*spdu 

pointer  to  SimuiationPDU 

p  sim.h 
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1  Calls  1 

Function 

Where  Described 

OBJ  VEHICLEID 

Sec.  2.9.1. 1  See  Appendix  A 

saf  id  from  simnet  id 

aet  me  a  random  fraction 

Sec.  2.14.3.7.1 

DEBUG  VEHICLE 

Sec.  2.5.2.2  See  Appendix  A 

IS  HELI 

IS  PLANE 

OBJ  VEHICLESTATUS 

II  'll* 

saf  vehicle  mobility  kill 

Sec.  2.6.1.1.23 

simnet  send  status  chanae 

Table  2.6*63:  damage_vehicle_rammed  CSU  [8.6.2.1.5] 


2.6.2. 1.6  damage_indirect_fire  CSU 
This  CSU  determines  the  damage  from  indirect  fire. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

*spdu 

pointer  to  SimulationPDU 

p  sim.h 

1  Calls  1 

Function 

Where  Described 

OBJ  VEHICLEID 

Sec.  2.9.1 .1  See  Appendix  A 

OBJ  POSITION 

OBJ  VEHICLESTATUS 

Sec.  2.9.1 .1  See  Appendix  A 

saf  id  from  simnet  id 

ranoe  squared 

Sec.  2.14.3.5.10 

qet  me  a  random  fraction 

Sec.  2.14.3.7.1 

database  if  damaqe  query 

Sec.  2.6.8.7  6 

DEBUG  VEHICLE 

saf  vehicle  catastrophic  kill 

Sec.  2.6.1.1.25 

simnet  send  status  chanqe 

saf  vehicle  mobility  kill 

Sec.  2.6.1.1.23 

saf  vehicle  firepower  kill 

Sec.  2.6.1.1.22 

Table  2.6-64:  damage_indirect_nre  CSU  [8.6.2.1.6] 
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2.6.3  Ground  Maneuver  CSC 


Figure  2.6-5:  Ground  Maneuver  CSC  Structure 


2.6.3. 1  collision. c  CSC 

/simnet/src/host/collision.c 

This  CSC  contains  the  code  which  handles  collisions  for  vehicles. 


Figure  2,6-6:  collision.c  CSC  Structure 
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In  addition,  the  file  contains  the  following  constant  definitions. 


Constant  lvalue 


COLLISION  STATE  WATCHING  I  1 


COLLISION  STATE  AVOIDING  VEHICLE  I  2 


COLLISION  STATE  AVOIDING  HOUSE  I  3 


COLLUSION  STATE  DISENGAGING 


COLLISION  DISTANCE 


COLLISION  DISTANCE  WITH  LEEWAY  |  7.0 


DISENGAGE  TIME 


DISENGAGE  MPS _ _ _ 1-7.0 


SCOOT  MPS  _ _ 12.0 


AVOIDANCE  DISTANCE  I  100.0 


CRITICAL  TIME  SECS  I  4.0 


HOUSE  LOOKAHEAD  TIME 


OBSTACE  EXPANSION  t  3  T  INTV 


SKIRT  DISTANCE  I  6.0 


Table  2.6-x:  collision.c  Constant  Definitions 


2.6.3. 1.1  create_collision  CSU 

This  CSU  allocates  memory  for  and  initializes  a  COLLISION_VARS  structure. 


Parameters 


collision 


Parameters 


Where  Typedef  Declared 


inter  to  COLLISION  VARS  Sec.  2.9.1. 2 


Return  Value 


collision 


lElT! 
lIsS 


ReturnValues 


e  Meanin 


inter  to  COLLISION  VARS  Created  collision. 


Function 


allocate  collision 


Calls 


Where  Described 


Sec.  2.9.1. 2  See  Appendix  A 


Table  2.6-65:  create  collision  CSU  [8.6.3.1.11 


2.6.3. 1.2  destroy_collision  CSU 

This  CSU  destroys  a  collision  through  a  call  to  CSU  deallocate_collision. 
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_ _ Calls _ 

Function _ Where  Described _ 

deallocate  collision  Sec.  2.9. 1.2  See  Appendix  A 

Table  2.6-66:  destroy_collision  CSU  [8.6.3.1.2] 

2. 6. 3. 1.3  coIIision_remove_vehicles  CSU 

This  CSU  causes  a  collision  to  be  removed. 


_  Parameters _ _ 

Parameters  I  Type  [Where  Typedef  Declared 

*collision _  pointer  to  COLLISION  VARS  Sec.  2.9.1 .2 _ 

num _ int _ Standard _ 

V  listM_ unsigned  int  Standard 


Calls 


Table  2.6-67:  collision_remove_vehicles  CSU  [8.6.3.1.3] 


2.6.3. 1.4  collision  show  CSU 


This  CSU  causes  the  vehicle  to  avoid  a  collision. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'collision 

pointer  to  COLLISION  VARS 

Sec.  2.9.1. 2 

flags 

int 

Standard 

Calls 

Function 

Where  Described 

OBJ  VEHICLEID 

Sec.  2.9. 1.1  See  Appendix  A 

Table  2.6  68:  collision  show  CSU  [8.6.3.1.4] 


2. 6. 3. 1.5  coiiision_disengaging  CSU 

This  CSU  sets  the  collision  state  to  COLLISION_STATE_DISENGAGING. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'collision 

pointer  to  COLLISION  VARS 

Sec.  2.9.1. 2 
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Table  2.6-69:  collision_disengaging  CSU  [8.6.3. 1.5] 


2. 6. 3. 1.6  colIision_tick  CSU 

This  CSU  processes  collisions  for  vehicles  which  are  mobile.  It  returns  FALSE  if  no 
collision  has  occurred.  It  rerums  a  pointer  to  the  collision  state  otherwise. 


Parameters 


‘safobi 


Parameters 


inter  to  SAP  OBJECT 


Where  Tvpedef  Declared 


Sec.  2.9. 1.1 


Return  Value 


FALSE 


collision->state ! 
COLLISION_STATE 
WATCHING 


ieit: 


ReturnVafues 


Meanin 


No  collision 


No  collision  if  collision  state  is 
set  to  the  value  for  watching. 
Collision  otherwise. 


Function 


LOOKUP  VEHICLE 


OBJ  FORCEID 


saf_vehicle_simulatorJn_com 

mand 


sbx  printf 


OBJ  VEHICLEID 


OBJ_OWNER_PORT_NUMB 

ER 


saf  vehicle  sudden  sto 


composite  halt 


saf  vehicle  halt 


DEBUG  COLLISION 


OBJ  POSITION 


saf  vehicle  collision  over 


detect  collision  tick 


start  disenaa 


detect  building  on  path  tick 


start  avoiding  house 


detect_imminent_collision_ 

tick 


start  avoiding  collision 


LOOKUP  POSITION 


FARTHER3 


Calls 


Where  Described 


Sec.  2.6.1.1.44 


endix  A 


endix  A 


Sec.  2.4.3  2.8 


endix  A 


Sec.  2.9. 1.1  See  Appendix  A 


Sec.  2.6.1.1.27 


Sec.  2.8.1.3.43 


Sec.  2.6.1.1.52 


Sec.  2.6.1.1.42 


Sec.  2.6.3.1.13 


Sec.  2.6.3.1.14 


Sec.  2.6.3.1.10 


Sec.  2.6.3.1.11 


Sec.  2.6.3.1.8 


endix  A 


endix  A 


Sec.  2.6.3. 1.9 


endix  A 


Sec.  2.14.3.9  See  Appendix  A 


Table  2.6-70:  collision  tick  CSU  [8.6.3.1.61 
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2.6.3. 1.7  collision_dead_tick  CSU 

This  CSU  processes  collisions  for  vehicles  which  cannot  move.  If  it  detects  a  collision,  it 
reptxts  it.  It  does  not  report  it  again  unless  the  driver  actually  disengages  and  re-collides. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described  1 

OBJ  POSITION 

LOOKUP  POSITION 

FARTHER3 

DEBUG  COLLISION 

OBJ  VEHICLEID 

detect  collision  tick 

Sec.  2.6.3.1.13  1 

Table  2.6-71:  collision  dead  tick  CSU  [8.6.3.1.7] 


2.6.3. 1.8  detect  imminent  collision  tick  CSU 


This  CSU  looks  for  an  imminent  collision  and,  if  it  finds  one,  sets  the  appropriate  variables 
in  collision  and  returns  TRUE. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

'collision 

pointer  to  COLLISION  VARS 

Sec.  2.9.1. 2 

‘entity 

pointer  to  ENTITY  VARS 

Sec.  2.9.1. 2 

1  ReturnVaiues  1 

Return  Value 

Meaning 

TRUE 

int 

Collision  is  imminent. 

FALSE 

int 

Cossision  is  not  imminent. 

1  Calls  1 

Function 

Where  Described 

FOR  VEHICLES  WITHIN  N 
GRIDS  DO 

Sec.  2.9.3.2  See  Appendix  A 

OBJ  POSITION 

OBJ  VELOCITY 

FARTHER2 

phase  two  collision  check 

Sec.  2.6.3.1.15 

DEBUG  COLLISION 

Sec.  2.5. 2.2  See  Appendix  A 

vec  copy 

OBJ  VEHICLEID 

Table  2.6-72;  detect  imminent  collision  tick  CSU  [8.6.3. 1.8] 
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2.6.3. 1.9  start_avoiding_collision  CSU 

This  CSU  chooses  a  speed  and  direction  to  avoid  a  collision. 


Parameters 


collision 


*saf  vehicle 


Parameters 


Where  Tvpedef  Declared 


inter  to  COLLISION  VARS  I  Sec.  2.9.1. 2 


pointer  to  Sec.  2.9.1 .2 

SAP  VEHICLE  VARS 


inter  to  ENTITY  VARS  I  Sec.  2.9.1. 2 


rs 

i 

rs 


Calls 


Function  Where  Described 


interior_angle_between_vect  Sec.  2.14.3.5.8 
ors 


almost  e 


VEC  LONGER2 


which  side  Sec.  2.14.3.5.9 


vec  z  rotate  Sec.  2. 


ndix  A 


ndix  A 


Table  2.6-73:  start_avoidlng_coIIision  CSU  [8.6.3. 1.9] 
2.6.3.1.10  detect_building_on_patli_tick  CSU 

This  CSU  looks  for  a  building  on  the  vehicle’s  path  and,  if  it  finds  one,  sets  the  appropriate 
variables  in  collision  and  returns  TRUE. 


Parameters 


collision 


saf  vehicle 


Parameters 


e  Where  Typedef  Declared 


inter  to  SAF  OBJECT  Sec.  2.9. 1.1 


inter  to  COLLISION  VARS  Sec.  2.9.1. 2 


pointer  to  Sec.  2.9. 1.2 

SAF  VEHICLE  VARS 


inter  to  ENTITY  VARS  I  Sec.  2.9.1 .2 


\wn^ 
irs 
irs 


ReturnValues 


Return  Value 


TRUE 


FALSE 


Meanin 


Buildi 


No  buildino  is  on  path. 


3I5EEIJI! 


Calls 

Function 

Where  Described 

buildinqs  thru 

Sec.  2.12,1.17.1 

DEBUG  COLLISION 

Sec.  2.5.2  2 

OBJ  VEHICLEID 

Sec.  2.9.1. 1 

Table  2.6-74:  detect_building_on_path_tick  CSU  [8.6.3.1.10] 
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2.6.3.1.11  start_avoiding_house  CSU 

This  CSU  chooses  a  speed  and  dii  ’X^tion  to  avoid  a  house. 


Parameters 


collision 


*saf  vehicle 


Parameters 


Where  Tvoedef  Declared 


inter  to  COLLISION  VARS  I  Sec.  2.9.1. 2 


pointer  to  Sec.  2.9.1 .2 

SAP  VEHICLE  VARS 


interto  ENTITY  VARS  I  Sec.  2.9.1. 2 


IS 

IS 


Function 


choose  skirt  point 


DEBUG  COLLISION 


vec  sub 


vec  normalize 


Calls 


Where  Described 


Sec.  2.6.3.1.16 


endix  A 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Table  2.6>75:  start_avoiding_house  CSU  [8.6.3.1.11] 


2.6.3.1.12  collision_vehicle_rammed  CSU 

This  CSU  accepts  a  report  that  a  collision  occurred  and  notes  the  information  for  the  next 
dck. 


Parameters 


*collision 


\U7^ 
IIS 


Parameters 


e  Where  Typedef  Declared 


inter  to  COLLISION  VARS  See.  2.9. 1.2 


inter  to  SimulationPDU  p  sim.h 


Function 


saf  Id  from  simnet  id 


vec  CO 


LOOKUP  POSITION 


LOOKUP  VELOCITY 


Calls 


Where  Described 


Sec.  6.2.59.1  Vehicles  CSCI  SDD 


endix  A 


endix  A 


Table  2.6-76:  collision  vehicle  rammed  CSU  [8.6.3.1.12] 


2.6.3.1.13  detect_collision_tick  CSU 

This  CSU  checks  to  see  if  we  hit  anybody  this  tick  and  checks  whether  anybody  hit  us 
since  the  last  tick. 


Parameters 


safobi 


collision 


*saf  vehicie 


Parameters 


Where  Tvoedef  Declared 


inter  to  SAF  OBJECT  Sec.  2.9.1. 1 


inter  to  COLLISION  VARS  Sec.  2.9.1. 2 


pointer  to  Sec  2.9.1. 2 

SAF  VEHICLE  VARS 


inter  to  ENTITY  VARS  Sec.  2.9.1 .2 


lltS 

irs 
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Returnvaiues 


Return  Value 


TRUE 


FALSE 


Meanin 


Collision  has  occurred. 


Collision  has  not  occurred. 


Function 


Calls 


Where  Described 


Sec.  2.12.1.17.2 


int  in  buildin 


DEBUG  COLLISION  Sec.  2.5.2.2  See  Appendix  A 


OBJ  VEHICLEID  Sec.  2.9.1. 1  See  Appendix  A 


OBJ  POSITION  Sec.  2.9. 1.1  See  Appendix  A 


FOR_VEHICLES_WITHIN_N_  See.  2.9.3.2  See  Appendix  A 
GRIDS  DO 


FARTHER3  Sec.  2.14.3.9  See  Appendix  A 


simnet  send  collision 


vec  copy  Sec.  2..6.2.59.1  Vehicles  CSCI  SDD 


LOOKUP  POSITION  Sec.  2.9. 1.1  See  Appendix  A 


LOOKUP  VELOCITY  I  Sec.  2.9.1. 1  See  Appendix  A 


Table  2.6-77:  detect  collision  tick  CSU  [8.6.3.1.13] 


2.6.3.1.14  start_disengaging  CSU 

This  CSU  checks  that  backing  up  is  appropriate  and  then  does  so. 


Parameters 


safobi 


collision 


saf  vehicle 


irs 

irs 


Parameters 


inter  to  SAF  OBJECT 


Where  Typedef  Declared 


Sec.  2. 9. 1.1 


inter  to  COLLISION  VARS  Sec.  2.9.1. 2 


pointer  to 

SAF  VEHICLE  VARS 


inter  to  ENTITY  VARS 


Sec.  2.9.1. 2 


Sec.  2.9.1. 2 


ReturnVaiues 


Return  Value 


TRUE 


FALSE 


Meanin 


Backino  up  is  not  appropriate. 


Function 


vec  init 


vec  sub 


interior_angle_between_vect 

ors 


VEC  SMALLER2 


saf  vehicle  sudden  sto 


vec  add 


vec  normalize 


vec  CO 


Calls 


Where  Described 


Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


Sec.  2.14.3.5.8 


ndix  A 


Sec.  2.6.1.1.27 


Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Table  2.6-78:  start_disengaging  CSU  [8.6.3.1.14] 
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2.6.3.1.15  phase_two_collisioii_check  CSU 

This  CSU  compares  the  position  and  velocity  vectors  of  two  vehicles  and  determines  if 
evasive  action  is  called  for. 


1  Parameters  1 

1  Parameters  1 

Type 

Where  Typedef  Declared 

pointer  to  REAL 

Sim  tvpes.h 

pointer  to  REAL 

Sim  types. h 

*mv  vel 

pointer  to  REAL 

Sim  tvpes.h 

*his  vel 

pointer  to  REAL 

Sim  tvpes.h 

*secs  until  collision 

pointer  to  REAL 

Sim  tvpes.h 

1  ReturnVaiues  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

Evasive  action  is  required. 

FALSE 

int 

Evasive  action  not  called  for. 

1  Calls  1 

Function 

Where  Described 

square 

Sim  macros.h 

Table  2.6-79:  phase_two_collisioii_check  CSU  [8.6.3.1.15] 


2.6.3.1.16  choose_skirt_point  CSU 

This  CSU  finds  a  way  around  an  obstacle.  If  chosen  dir  is  0,  it  chooses  the  best  skirt 
point;  if  -1,  it  chooses  the  skirt  point  on  the  left;  if  1,  the  skirt  point  on  the  right. 
chosenjiir  is  set  to  the  direction  decided  upon  so  it  can  be  us^  on  the  next  pass,  if  one 
necessary. 


1  Parameters 

Parameters 

Where  Typedef  Declared 

•pos 

pointer  to  REAL 

Sim  tvpes.h 

*dir 

pointer  to  REAL 

Sim  tvpes.h 

^obstacle 

pointer  to  register  RECT 

Sec.  2.14.3.9 

pointer  to  register  REAL 

Sim  tvpes.h 

1  *chosen_  dir 

pointer  to  int 

Standard 

1  Calls 

Function 

Where  Described  1 

DEBUG  COLLISION 

1  1 1  II  ■  ■■■■■■■— 

which  side 

Sec.  2.14.3.5.9 

interior_angle  _between_vect 
ors 

Sec.  2.14.3.5.8 

Table  2.6-80:  choose_skirt_point  CSU  [8.6.3.1.16] 
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2. 6. 3. 2  driver.c  CSC 

driver.c  1 

CSC  1 

8.6.3.2  1 

1  f  create  drive.  ^  i 

f  destroy  driver  A  f  driver  remove  vehicles  A  I 

V  CSU  8.6.3.2.1  J  ' 

k.  CSU8.6.3.2.2  J  V  CSU8.6.a2.3  J  1 

1  f  dnver  tick  A  . 

r  stop  ^  f  set  speed  dir  ^ 

K  CSU8.6.3.2.4  J  ' 

1  CSU  8  6.3.2.5  J  V  CSU  8.6.3.2  6  J 

1  f  next  route_point  A 

V.  CSU  8.6.32.7  j 

f  vel2point  ^  f  mission  stationpoint  ^ 

V  CSU8.6.3.2.8  J  \  CSU  8.6..3.2.9  J 

f  stationpoint  A  i 

V  CSU  8.6.3.2.10  J  \ 

f  get  unit  direction  A  f  driver  simulator  in  A 

CSU  8.6.3.2.11  J  V  command  CSU  8.6.3.2.12  J 

1  (  get  leader  state  A 

V  CSU  8.6.3.2.13  J 

f  followvehide  A  ^driver  executing  immediate  A 

V.  CSU  8.6.3.2.14  J  V  command  CSU  8.6.3.2.15  J 

1  f  arrver  mission  compieieo  \ 

1  V  CSU  8.6,3.2.16  J 

f  driver  execute  overlay  A  f  driver  set  leader  mis  A 

V  CSU  8.6.3.2.17  J  V  CSU  8.6.3.2.18  J 

1  f  driver  follow  leader  A  j 

^  driver  stop  mission  A  driver  forget  about  forpsA 

V  CSU  8.6.3.2.19  J  ' 

1  CSU  8.6.3.2.20  J  V  CSU  8.6.3.2.21  J 

f  dnver_set  route  A  i 

f  driver  sot  speed  A  f  driver  set  Direction  A 

V  CSU  8.6.3.2.22  J  \ 

C  CSU  8.6.3.2.23  J  V  CSU  8.6.3.2.24  J 

1  (  driver  set  routedirection  A 

^river  resume  ftom  collisiom  r  driver  halt  cmd  A 

1  V  CSU  8.6.3.2.25  J 

k.  CSU  8.6.3.2.26  J  V  CSU  8.6.3.2.27  J 

1  f  driver  follow  vehicle  A  i 

^  driver jgoto_point_cmd  ^  ^  driver  face  direction  ^ 

V  cmd  CSU  8.6.3.2.28  J  \ 

CSU  8.6.3.2.29  J  V  cmd  CSU  8.6.3.2.30  J 

driver  resume  mission  A 

r  driver_resumo_cmd  A  r  driver  change  speed  cmdA 

fV  cmd  CSU  8.6.3.2.31  J 

V  CSU  8.6.32:32  J  V  CSU  8  6  3  2  33  J 

1  Figure  2.6*7: 

driver.c  CSC  Structure  Part  1  of  2 
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Figure  2.6-8:  driver.c  CSC  Structure  Part  2  of  2 
In  addiidon  to  the  CSUs  contained  in  this  CSC  there  are  three  constants  defined. 


Constant 


LEADER  CORRIDOR 


CATCHUP  TIME  NORMAL 


CATCHUP  TIME  BRIDGE 


Value 


Table  2.6-81:  driver.c  Constants 


2. 6. 3. 2.1  create  driver  CSU 


This  CSU  creates  a  driver. 


Parameters 


max  err2 


Parameters 


e 


REAL 


Where  Tvpedef  Declared 


Sim  t 


Return  Value 


driver 


ReturnValues 


inter  to  DRIVER  VARS 


Meanin 


Created  driver. 


Calls 


Function  I  Where  Described 


allocate  driver  Sec.  2.9. 1.2  See  Aopendix  A 


vec  set  Sec.  2.6.3.2.36 


vec  init  Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 


Table  2.6-82:  create  driver  CSU  [8.6.3.2.1] 
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2. 6. 3. 2. 2  destroy_drlver  CSU 

This  CSU  destroys  a  driver  by  calling  deallocate_driver. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Calls 

Function 

Where  Described 

deallocate  driver 

Sec.  2.9.1. 2  See  Appendix  A 

Table  2.6>83:  destroy_dnver  CSU  [8.6.3.2.2] 


2. 6. 3. 2. 3  driver_remove_vehicles  CSU 

This  CS  'emoves  the  lead  vehicle. 


1  Parameters  1 

Parameters 

wpnmammmmmm 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

num 

int 

standard 

V  Hstn 

unsigned  int 

Standard 

1  Calls  1 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9.1. 1  See  Appendix  A 

Table  2.6*84:  driver_remove_vehicIes  CSU  [8.6.3.2.3] 


2. 6. 3. 2. 4  driver  tick  CSU 


This  CSU  is  the  driver  state  machine. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Errors  I 

Error  Name 

Reason  for  Error 

’Veh ...  has  lost  his  immediate 
leader” 

There  is  no  immediate  leader  for  the  vehicle. 

"driver ...  in  illegal  immediate 
state’ 

Value  in  driver->immediate  is  none  of  the  expected  states. 

"Veh  ...  has  lost  its  routepoint" 

There  is  no  routepoint  for  this  driver. 

"Veh  ...  has  no  leader  to 
follow" 

There  is  no  leadveh  tor  this  driver. 

BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


1  Calls  1 

Function 

Where  Described 

stop 

Sec.  2.6.3.2.5 

within  delta 

Sec.  2.14.1.2.10 

vel2D0int 

Sec.  2.6.3  2.8 

followvehicle 

Sec.  2.6  2.2.14 

ERROR  OUT 

Table  2.6-85:  driver_tick  CSU 

[8.6.3.2.41 

2. 6. 3. 2. 5  stop  CSU 

This  CSU  causes  a  vehicle  to  stop. 

1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

‘direction 

pointer  to  REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

Table  2.6*86:  stop  CSU  [8.6.3.2.5] 


2. 6. 3. 2. 6  set_speed_dir  CSU 


This  CSU  sets  the  speed  and  direction. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

speed 

REAL 

sim  types. h 

direction 

REAL 

sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

vec2  norm 

Sec.  2.14.3.5.31 

Table  2.6-87:  5et_speed_dir  CSU  [8.6.3.2.6] 
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2. 6. 3. 2. 7  next_route_point  CSU 


This  CSU  sends  the  driver  to  the  next  route  point. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*safobj 

1  pointer  to  CAr  OOJFnT  1 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

stop 

Sec.  2.6.3.2.5 

Table  2.6-88:  next_route_point  CSU  [8.6.3.2.7] 


2. 6. 3. 2. 8  vel2point  CSU 


This  CSU  determines  the  speed  required  to  get  to  the  next  point  and  sets  it. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

•point 

pointer  to  REAL 

Sim  types. h 

•position 

pointer  to  REAL 

Sim  types.h 

speed 

REAL 

Sim  types.h 

direction 

int 

Standard 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2. 9. 1.1 

Calls 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  mao 

Sec.  2.14.3.5.26 

min 

Sec.  2.13.3.5  See  Appendix  A 

vec  set 

Sec.  2.6.3.2.36 

vec.copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

Table  2.6-89:  vel2point  CSU  [8.6.3.2.8] 


2. 6. 3. 2. 9  mission_stationpoint  CSU 


241 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


[  Calls  1 

Function 

Where  Described 

stationooint 

Sec.  2.6.3.2.10 

Table  2.6-90: 

mission_stationpoint  CSU  [8.6.3.2.9] 

2.6.3.2.10  stationpoint 

CSU 

1  Parameters  I 

1  Parameters 

Where  Typedef  Declared 

VECTOR 

Sim  tvpes.h 

leadvei 

VECTOR 

Sim  types. h 

leaddir 

VECTOR 

sim_types.h 

offsetv 

VECTOR 

simjypes.h 

point 

VECTOR 

simjypes.h 

1  Calls  1 

Function 

Where  Described 

vec2  COPY 

Sec.  2.14.3.5.29 

vec  normalize 

Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 

vec2  veh2world 

Sec.  2.6.3.2.37 

vec2  add 

Sec.  2.14.3.5.22 

Table  2.6-91:  stationpoint  CSU  [8.6.3.2.10] 


2.6.3.2.11  get_unit_direction  CSU 

This  CSU  determines  the  direction  of  the  lead  vehicle. 


1  Parameters 

Parameters 

Where  Typedef  Declared 

*leadveh 

pointer  to  SAF  OBJECT 

Sec.  2. 9. 1.1 

unitdir 

VECTOR 

Sim  types.h 

‘unitspeed 

pointer  to  REAL 

simjypes.h 

samity 

int 

Standard 

1  Calls 

Function 

Where  Described 

get.  unit  direction 

Sec.  2.6.3.2.11 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

vec2  mag 

Sec.  2.14.3.5.26 

vec2  dot 

Sec.  2.14.3.5.24 

Table  2.6-92:  get_unit_direction  CSU  [8.6.3.2.11] 
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2.6.3.2.12  driver  simulator  in  command  CSU 


Parameters 


•driver 


Parameters  _ 


Where  Tvpedef  Declared 


ter  to  DRIVER  VARS  I  Sec.  2.9.1.2 _ 


int  I  Standard  _ 


lit.'tiiii 


Return  Value 


TRUE  int 


FALSE  int 


leadveh->driver  &&  dnver_  int 
simulator  in  commandi...) 


Recursion. 


Calls 


Function  Where  Described  _ 


driver  simulator  in  command  Sec.  2.6.3.2.12  _ 


Table  2.6-93:  driver  simulator  in  command  CSU  [8.6.3.2.12] 


2.6.3.2.13  get_leader_state  CSU 
This  CSU  determines  the  state  of  the  lead  vehicle. 


Parameters 


Parameters 


•ieadveh 


os 


vel 


dir 


speed 


iltS 


leader  route  dir 


inter  to  SAF  OBJECT 


VECTOR 


VECTOR 


VECTOR 


REAL 


pointer  to  pointer  to 
ROUTEPOINT 


inter  to  int 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


sim  t 


Sim  t 


sim  t 


Sec.  2.10.2.5 


Standard 


ReturnValues 


Return  Value 


et  leader  state 


leader  behavior 


unsioned  short 


unsianed  short 


Meanin 


Recursion. 


Resultina  leader  behavior. 


Function 


vec2  CO 


vec2  ma 


vec2  dot 


LOOKUP  VEHICLE 


et  leader  state 


remote  next  road 


vec  normalize 


Calls 


Where  Described 


Sec.  2.14.3.5.29 


Sec.  2.14.3.5.26 


Sec.  2.14.3.5.24 


endix  A 


Sec.  2.6.3.2.13 


Sec.  2.7. 1.9 


Sec.  2.6.2.63.1  Vehicles  CSCl  SDD 


Table  2.6-94:  getjeader^state  CSU  [8.6.3.2.13] 
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2.6.3.2.14  followvehicle  CSU 

This  CSU  causes  the  vehicles  to  follow  the  lead  vehicle. 


Parameters 


sition 


leadveh 


offset 


safobi 


•*forp 


fom  dir 


Parameters 


I  VEOT 


J  pointer  to  SAP  OBJECT 


VECTOR 


I  pointer  to  SAP  OBJECT 


pointer  to  pointer  to 
ROUTEPOINT 


inter  to  int 


Where  Tvpedef  Declared 


sim 


Sec.  2.9.1 .1 


sim  t 


Sec.  2.9.1. 1 


Sec.  2.10.2.5 


Standard 


Calls 

Function 

Where  Described 

saf  vehicle  doino  collision  s 
tuff 

Sec.  2.6.1.1.43 

set  speed  dir 

Sec.  2.6.3  2.6 

et  leader  state 


within  delta 


abs 


vec2  sub 


vec2  dot 


set  speed  dir 


uare 


almost  e 


min 


max 


et  unit  direction 


vec2  scale 


vec  CO 


vec2  norm 


vec2  world2veh 


vec2  add 


vec  scale 


Sec.  2.6.3.2.13 


Sec.  2.14.1.2.10 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  A 


Sec.  2.14.3.5.23 


Sec.  2.14.3.5.24 


Sec.  2.6  3.2.6 


sim  macros.h 


ndix  A 


ndix  A 


ndix  A 


Sec.  2.6.3.2.8 


Sec.  2.6.3.2.11 


Sec.  2.14.3.5.28 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.14.3.5.31 


Sec.  2.6.3.2.38 


Sec.  2.14.3.5.22 


Sec.  2.6  3.2.5 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


ndix  A 


Table  2.6-95:  followvehicle  CSU  [8.6.3.2.14] 
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Table  2.6-96:  driver_executmg_iminediate_command  CSU  [8.6.3.2.15] 


2.6.3.2.16  driver_inissioii__completed  CSU 

This  CSU  returns  TRUE  if  the  driver  is  immediately  inactive.the  driver  is  the  driver 
missicm  is  idle,  lost  in  any  way,  or  if  the  end  of  route  has  been  reached.  It  returns  FALSE 
otherwise. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•driver 

DOinter  to  DRIVER  VARS 

Sec.  2.9.1. 2 

1  ReturnVaiues  1 

Return  Value 

TRUE 

int 

Driver  is  immediately  inactive, 
or  driver  mission  is  idle,  end  of 
route,  or  lost  in  any  way. 

FALSE 

int 

Driver  is  anythina  else. 

Table  2.6-97:  dnver_mission_completed  CSU  [8.6.3.2.16] 


2.6.3.2.17  driver_execute_overIay  CSU 


This  CSU  causes  the  driver  to  execute  the  current  overlay. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•unit 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•overlay 

pointer  to  OVERLAY 

Sec.  2.10.2.2 

•cm 

pointer  to 

CONTROL  MEASURE 

Sec.  2.10.2.2 

Errors 

Error  Name 

Reason  for  Error 

•Cannot  execute  anything  but 
route" 

Control  measure  is  not  of  type  route. 

1  Calls  1 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5.2.2  See  Appendix  A 

driver  resume  mission  cmd 

Sec.  2.6.3.2.31 

Table  2.6-98:  driver_execute_overlay  CSU  [8.6.3.2.17] 
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2.6.3.2.18  driver  set  leader  mis  CSU 


Parameters 


vid 


X  offset 


y offset 


Parameters 


e 


inter  toSAF  OBJECT 


unsioned  int 


int 


mt 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Standard 


Standard 


Standard 


Error  Name 


Veh  ...  told  to  follow 
nonexistant  vehicle” 


veh  ...  cannot  follow  itself 


Errors 


Reason  for  Error 


No  lead  vehicle. 


This  vehicle  is  the  lead  vehicle. 


Function 


LOOKUP  SAFOBJ 


ERROR  OUT 


abort 


Calls 


Where  Described 


Sec.  2.9. 1.1  See  Aooendix  A 


Sec.  2.5.2.2  See  Appendix  A 


Table  2.6-99;  driver_set_leader_mis  CSU  [8.6.3.2.18] 


2.6.3.2.19  driver  follow  leader  CSU 


Parameters 


safobi 


\im 
IIS 


Parameters 


e  Where  Typedef  Declared 


inter  toSAF  OBJECT  I  Sec.  2.9.1. 1 


Errors 


Reason  for  Error 


Error  Name 


veh  ...  Unable  to  follow,  no  No  lead  vehicle 
leader" 


Function 


ERROR  OUT 


abort 


Calls 


Where  Described 


Sec.  2.5.2.2  See  Aooendix  A 


Table  2.6-100:  driver  follow  leader  CSU  [8.6.3.2.19] 


2.6.3.2.20  driver_stop_mission  CSU 


Parameters 


'driver 


IIS 


Parameters 


inter  to  DRIVER  VARS 


Where  Tvoedef  Declared 


Sec.  2.9.1. 2 


Table  2.6-lOt:  driver_stop_mission  CSU  [8.6.3.2.20] 
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2.6.3.2.21  driver__forget_about_forps  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

‘driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

Table  2.6-102:  driver_forget_about_forps  CSU  [8.6.3.2.21] 


2.6.3.2.22  driver_set_route  CSU 
This  CSU  sets  the  route. 


I  Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

‘driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

‘route 

pointer  to  ROUTE 

Sec.  2.10.2.5 

‘routepoint 

pointer  to  ROUTEPOINT 

Sec.  2.10.2.5 

Table  2.6-103:  driver_set_route  CSU  [8.6.3.2.22] 


2.6.3.2.23  driver_set_speed  CSU 
This  CSU  sets  the  speed  to  speed. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

‘driver 

pointer  to  DRIVER  VARS 

Sec  2.9.1. 2 

speed 

REAL 

Sim  ivpes.h 

1  ReturnValues  1 

Return  Value 

Meanina 

!driver->useimspeed 

int 

new  speed 

Table  2.6-104:  driver_set_speed  CSU  [8.6.3.2.23] 


2.6.3.2.24  driver_set_direction  CSU 
This  CSU  sets  the  direction  to  direction. 


1  Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

‘driver 

pointer  to  DRIVER  VARS 

Sec.  2.9. 1.2 

direction 

int 

Standard 

Table  2.6-105:  driver  set  direction  CSU  [8.6.3.2.24] 
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2.6.3.2.25  driver_set_routedirection  CSU 
This  CSU  sets  the  routedirection  to  routedirection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9. 1.2 

routedirection 

int 

Standard 

Table  2.6-106:  driver_set_routedirection  CSU  [8.6.3.2.25] 


2.6.3.2.26  driver  resume  from  collision  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

•box 

pointer  to  RECT 

Sec.  2.14.3.9 

Calls 

Function 

Where  Described  1 

point  in  rect 

Table  2.6-107:  driver_resume_from_collision  CSU  [8.6.3.2.26] 


2.6.3.2.27  driver__haU_cmd  CSU 
This  CSU  causes  the  driver  to  stop. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2..9.1.2 

Table  2.6-108:  driver  halt  cmd  CSU  [8.6.3.2.27] 


2.6.3.2.28  driver_follow_vehicle_cmd  CSU 
This  CSU  causes  the  driver  to  follow  a  lead  vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9. 1.2 

vid 

unsigned  int 

Standard 

xoft 

int 

Standard 

voff 

int 

Standard 

Errors 

Error  Name 

Reason  for  Error 

”Veh  ...  told  to  follow 
nonexistant  vehicle" 

No  lead  vehicu 
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1  Calls  1 

Function 

Where  Described 

LOOKUP  SAFOBJ 

Sec.  2.9.1. 1  See  Aooendix  A 

ERROR  OUT 

Sec.  2.5.2.2  See  Appendix  A 

abort 

vec  set 

Sec.  2.6.3.2.36 

Table  2.6-109:  driver  follow  vehicle  cmd  CSU  [8.6.3.2.28] 


2.6.3.2.29  driver_goto_point_cind  CSU 
This  CSU  causes  the  driver  to  go  to  a  designated  point. 


I 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

X 

REAL 

Sim  types.h 

y 

REAL 

sim_types.h 

backwardp 

int 

Standard 

Calls 

Function 

Where  Described 

vec  set 

Sec.  2.6.3.2.36 

Table  2.6-110:  driver_goto_point_cmd  CSU  [8.6.3.2.29] 


2.6.3.2.30  driver_face__direction_cmd  CSU 


This  CSU  causes  the  driver  to  face  a  designated  direction. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

mathradians 

REAL 

sim  types.h 

Calls 

Function 

Where  Described 

vec  set 

Sec.  2.6.3.2.36 

Table  2.6-111:  driver_face_direction_cmd  CSU  [8.6.3.2.30] 

I 
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2.6.3.2.31  driver_resume_mission_cmd  CSU 
This  CSU  causes  the  driver  to  resume  the  mission. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

•driver 

DOinter  to  DRIVER  VARS 

Sec.  2.9. 1.2 

Table  2.6*112:  driver  resume  mission  cmd  CSU  [8.6.3.2.31] 


2.6.3.2.32  driver  resume  cmd  CSU 


This  CSU  is  obsolete. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

1  Calls  1 

Function 

Where  Described 

driver  resume  mission  cmd 

Sec.  2.6.3.2.31 

Table  2.6*113:  driver_resume_cmd  CSU  [8.6.3.2.32] 


2.6.3.2.33  driver_change_speed_cmd  CSU 


This  CSU  causes  the  driver  to  change  speed. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1 .2 

speed 

REAL 

Sim  types. h 

Table  2.6-114:  driver_change_speed_cmd  CSU  [8.6.3.2.33] 


2.6.3.2.34  driver_set_direction_cmd  CSU 
This  CSI J  sets  the  new  direction. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9.1. 2 

direction 

int 

Standard 

Calls 

Function 

Where  Described 

driver  set  direction 

Sec.  2.6.3.2.24 

Tabic  2.6*115:  driver_set_direction_cmd  CSU  [8.6.3.2.34] 
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2.6.3.2.35  driver  set  route  direction  c  id  CSU 


This  CSU  sets  the  new  route  direction. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘driver 

pointer  to  DRIVER.  VARS 

Sec.  2.9.1. 2 

routedirection 

int 

Standard 

Calls 

Function 

Where  Described 

driver  set  routedirection 

Sec.  2.6.3.2.25 

Table  2.6-116:  driver  set  route  direction  cmd  CSU  [8.6.3.2.35] 


2.6.3.2.36  vec  set  CSU 


This  CSU  assigns  values  to  the  components  of  a  vector. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

V 

VECTOR 

Sim  types. h 

X 

REAL 

Sim  tvpes.h 

V 

REAL 

Sim  tvpes.h 

z 

REAL 

Sim  tvpes.h 

Table  2.6-117:  vec  set  CSU  [8.6.3.2.36] 


2.6.3.2.37  vec2  veh2worId  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

directionx 

REAL 

Sim  tvpes.h 

directionv 

REAL 

Sim  tvpes.h 

offsetv 

VECTOR 

Sim  tvpes.h 

offsetw 

VECTOR 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

vec  copv 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

Table  2.6-118:  vec2  veh2world  CSU  [8.6.3.2.37] 
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2.6.3.2.38  vec2  world2veh  CSU 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

directionx 

REAL 

Sim  types.h 

directiony 

REAL 

Sim  types.h 

offsetv 

VECTOR 

Sim  types.h 

offsetw 

VECTOR 

Sim  types.h 

Calls 

Function 

Where  Described 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

Table  2.6-119:  vec2  worid2veh  CSV  [8.6.3.2.38] 


2.6.3.2.39  printmission  CSU 

This  CSU  prints  the  current  status  of  a  mission. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

mode 

int 

Standard 

Table  2.6-120:  printmission  CSU  [8.6.3.2.39] 


2.6.3.2.40  printdirection  CSU 
This  CSU  prints  the  current  vehicle  direction. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

mode 

int 

Standard 

Table  2.6-121:  printdirection  CSU  [8.6.3.2.40] 


2.6.3.2.41  printroutedirection  CSU 
This  CSU  prints  the  current  route  direction. 


1  Parameters  i 

Parameters 

Type 

Where  Typedef  Declared 

mode 

int 

Standard 

Table  2.6-122:  printroutedirection  CSU  [8.6.3.2.41] 
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2.6.3.2.42  printimmediate  CSU 


This  CSU  prints  the  current  state  of  a  saf  object. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

mode 

int 

Standard 

Table  2.6>123:  printimmediate  CSU  [8.6.3.2.42] 


2.6.3.2.43  driver  show  CSU 


This  CSU  prints  the  current  state  of  the  driver. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•driver 

pointer  to  DRIVER  VARS 

Sec.  2.9. 1.2 

flaos 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

printimmediate 

Sec.  2.6.3.2.42 

OBJ  VEHICLEID 

Sec.  2.9. 1.1  See  Appendix  A 

print  vector 

Sec.  2.14.3.5.2 

print  routepoint 

Sec.  2.10.2.4.16 

print  mission 

Sec.  2.6.3.2.39 

printdirection 

Sec.  2.6.3.2.40 

print  routedirection 

Sec.  2.6.3.2.41 

print  route 

Sec.  2.10.2.4.17 

Table  2.6-124:  driver  show  CSU  [8.6.3.2.43] 


> 
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2.6. 3.3  driver.h  CSU 
/simnet/src/host/driverh 


This  file  contains  all  tiic  s;  ibolic  constants  used  by  the  driver.c  CSU  in  the  following 
table. 


Constant 

Value 

IDLE 

0  r  follow  mode  */ 

ENDROUTE 

1 

LOSTROUTE 

2 

LOSTROUTEPOINT 

3 

LOSTLEADER 

6 

FOLLOWROUTE 

8 

FOLLOWVEHICLE 

9 

FORWARD 

0  /*  direction,  routedirection  */ 

REVERSE 

1 

INACTIVE 

0  /*  immediate  */ 

GOTOPOINT 

1 

ATPOINT 

2 

FACEDIRECTION 

3 

HALT 

IMFOLLOWVEH 

5 

IMLOSTVEH 

6 

LEADERS  ACTUAL 

0  /*  follow  aloorithms  V 

LEADERS  DESIRED 

1 

LEADERS  LEADER  ACTUAL 

2 

LEADER  ON  ROAD 

1 

LEADER  ON  DIRT 

2 

LEADER  ON  BRIDGE 

3 

GRND  MIN  TURN  SPEED 

2.0  r  aeneral  V 

GRND  MAX  BACKUP  DIST2 

400.0 

GRND  MAX  BACKUP  SPEED 

Table  2.6-125:  driver.h  Constants 
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2. 6. 3. 4  groundveh.c  CSC 
/simnet/sTC^ost/groundveh.c 

This  file  contains  all  of  the  CSUs  specific  to  ground  vehicles,  including  creation,  deletion, 
and  handling  everything  being  done  by  a  ground  vehicle  during  each  tick. 


create_groundveh 

CSU  8.6.3.4.1 


^  f  destroyjgroundveh  A  ( 
V  CSU  8.6.3.4.2  J 


groundveh_move  ^ 

CSU  8.6.3.4.3  J 


(groundveh_tick  3roundveh^mobility_kill  ^  ^ groundvehjdose_enough  ^ 

CSU  e.6.3.4.4  J  V  CSU  8.6.3.4.S  J  V  CSU  8.6.3.4.6  J 

Figure  2.6-9:  groundveh.c.c  CSC  Structure 

The  sine  of  45  degrees  is  defined  as  a  constant  within  the  groundveh_tick  CSU  (#define 
SIN_45  0.707). 


2. 6. 3. 4.1  create_groundveh  CSU 


This  CSU  creates  a  ground  vehicle. 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

Mable 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

*saf_vehicle 

pointer  to 

SAF  VEHICLE  VARS 

Sec.  2.9.1. 2 

ReturnValues 

Return  Value 

Meaning 

groundveh 

pointer  to 

GROUNDVEH  VARS 

Created  ground  vehicle. 

Calls 

Function 

Where  Described  1 

allocate  aroundveh 

mat  rot  init 

dea  to  rad 

Sim  macros.h 

mat  mat  mul 

kph  to  mps 

ft  .float 

Sec.  2.14.1.2.12  1 

Table  2.6-126:  create_groundveh  CSU  [8.6.3.4.1] 
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2. 6. 3. 4. 2  destroy_groundveh  CSU 


This  CSU  deallocates  the  memory  allocated  for  the  ground  vehicle  passed  as  the  parameter. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘groundveh 

pointer  to 

GROUNDVEH  VARS 

Sec.  2.9. 1.2 

1  Calls  1 

Function 

Where  Described  1 

deallocate  aroundveh 

Table  2.6-127:  destroy_groundveh  CSU  [8.6.3.4.2] 


2. 6. 3. 4. 3  groundveh_move  CSU 

This  CSU  coordinates  the  movements  of  a  ground  vehicle. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*saf_vehicle 

pointer  to 

SAF  VEHICLE  VARS 

Sec.  2.9.1. 2 

*groundveh 

pointer  to 

GROUNDVEH  VARS 

Sec.  2.9. 1.2 

•vehicle 

pointer  to  VEHICLE  VARS 

Sec.  2.9.1. 2 

•entity 

pointer  to  ENTITY  VARS 

Sec.  2.9.1. 2 

time  step 

REAL 

Sim  tvpes.h 

on  road 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

angle  between  vectors 

Sec.  2.14.3.5.7 

abs 

Sec.  2.6  7.3  &  Sec.  2.13.3.2  See  Appendix  A 

min 

Sec.  2.13.3.5  See  Appendix  A 

vec  z  rotate 

RANGE  CLIP 

Sec.  2.14.3.9  See  Appendix  A  I 

almost  eg 

s  atan2 

tdb  place  vehicle 

Sec.  2.21.7.20.5 

report  error  from  tdb  once 

Sec.  2.14.1.2.4 

mat  rot  init 

Sec.  2.6.2.47.1  Vehicles  CSCl  SDD 

get  soil  type 

Sec.  2.14.1.2.1 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCl  SDD 

copy  matrix  row  to  vector 

Sec.  2.14.3.5.18 

Tabic  2.6-128:  groundveh_move  CSU  [8.6.3.4.3] 


256 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2. 6. 3. 4. 4  groundveh_tick  CSU 


This  CSU  models  a  ground  vehicle  on  a  tick  by  tick  basis. 


1  Parameters  1 

Parameters 

Type 

;rTr»  •;  ■  »i  jJktTga 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1  1 

1  Errors  1 

Error  Name 

Reason  for  Error 

"Unknown  soil  type .... 

Value  ingrourKfveh->iast_soiLtype  is  none  of  the  expected 
soil  types. 

1  Calls  1 

Function 

Where  Described 

groundveh  move 

Sec.  2.6.3.4.3 

mat  mat  mul 

Sec.  2.6.2.32.1  Vehicles  CSCI  SDD 

ERROR  OUT 

composite  note  leader  state 

Sec.  2.8.1.3.36 

composite_inferior_changed_ 

status 

Sec.  2.8.1.3.37 

abs 

Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 

RANGE  CLIP 

Sec.  2.14.3.9  See  Appendix  A  I 

DEBUG  GROUNL 

groundveh  move 

Sec.  2.6.3.4.3 

water  check 

Sec.  2.12.1.4.4 

vec  Jnit 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

Table  2.6-129:  groundvehjick  CSU  [8.6.3.4.4] 


2. 6. 3. 4. 5  ground veh_mobility_kiII  CSU 


This  CSU  renders  a  ground  vehicle  immobile. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

"groundveh 

pointer  to 

GROUNDVEH  VARS 

Sec.2  9.1.2 

Table  2.6-130:  groundveh_mobility_kill  CSU  [8.6.3.4.5] 
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2. 6. 3. 4. 6  groundveh_close_enough  CSU 

This  CSU  determines  if  the  vehicle  is  close  enough  to  a  given  point 


1  Parameters 

Parameters 

Tvoe 

Where  Tvpedef  Declared 

•saf_vehicle 

pointer  to 

SAF  VEHiCLE  VARS 

Sec.  2.9.1 .2 

•entity 

pointer  to  ENTITY  VARS 

Sec.  2.9.1 .2 

•despos 

REAL 

simjypes.h 

1  ReturnValues 

Return  Value 

Meanina 

within_delta(...) 

int 

the  vehicle  was  within  the 
required  toierance. 

1  Calls 

Function 

Where  Described 

within  deita 

Sec.  2.14.1.2.10 

Table  2.6*131:  ground veh_close_enough  CSU  [8.6.3.4.6] 
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2.6.4  Air  Maneuver  CSC 


Figure  2.6*10:  Air  Maneuver  CSC  Structure 


2.6.4. 1  helo.c  CSC 


/simnet/src/host/helo.c 


This  CSC  handles  eveiything  that  needs  to  be  done  by  a  helicopter  each  tick.  This  consists 
of  a  single  CSU  helo_tick(),  the  constant  definition  for  the  maximum  helicopter  power, 
the  values  in  three,  three  element  arrays,  and  values  for  six  REAL  variables. 


Constant 

Value 

MAX  HELICOPTER  POWER 

500000  r  Newtons**/ 

Table  2.6-132:  helo.c  Maximum  Helicopter  Power 


Array 

Values 

REALM  INERTIAfl 

{  10000.0.  5000.0,  10000.0  1 

REALM  Kill 

(  6000.0.  4000.0.  6000.0  ] 

REALM  K2ri 

(  18000.0.  12000.0,  13000.0  ) 

Table  2.6-133:  helo.c  Array  Constants 


Variable 

Value 

REAL  H  K4 

.03 

REAL  H  K5 

.05 

REALM  K6 

.03 

REAL  H  K7 

2  /**  Airdrao**/ 

REAL  H  K8 

40  r*  Airdrao**/ 

REAL  H  KP 

20000.0 

Table  2.6-134:  helo.c  Assigned  Variables 
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Figure  2.6-11:  helo.c  CSC  Structure 


2.6.4. 1.1  helojick  CSU 

This  CSU  is  responsible  for  the  tick  by  tick  simulation  of  the  hellicopters. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

1  Calls  1 

Function 

Where  Described  1 

min 

1  Mil  — — — 

max 

Sec.  2.13.3.6  See  Appendix  A 

abs 

Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 

almost  eq 

square 

Sim  macros.h  ! 

s  atan2 

r-  K  S!  ^JT »]  »T  J  iT» 

induce  tail  spin 

Sec.  2.6.4.6.10 

r  r 

Sec.  2.6.4.6.8 

RANGE  CLIP 

Sec.  2.14.3.9  See  Appendix  A 

vec  maqS 

Sim  macros.) 

copy  matrix  row  to  vector 

Sec.  2.14.3.5.18 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

Table  2.6-135; 


helo  tick  CSU  [8.6.4.1.1] 
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2. 6. 4. 2  pilot.c  CSC 

/simnet/src/host/pilotx 

The  pilot  code  handles  the  moving  of  an  air  vehicle;  where  it  needs  to  go  (NOT  determining 
where  that  is),  much  like  the  driver  code  for  ground  vehicles 


pilot.c 

CSC 

8.6.4.2 

1  1 

1 _ 

r  pilot  state  to  string 

V  CSU  8.6.4.2.1 

3C 

create_pilot 
CSU  8.6.4.2.2 

DC 

init_pilot  state  machine  ^ 
CSU  8.6.4.2.3  J 

"  T  ■ 

~  ~l_ I 

■  1 

r  destroy _pilot 

V  CSU  8.6.4.2.4 

'N  r  pilot  remove  vehicles  A  f 

J  \  CSU  8.6.4  2.5  J  V 

pilot  show_machine  'N 
CSU  8.6.4.2  6  J 

■  "  r  ■  ■ 

1 

1 

f  pilot  show 

V  CSU  8.6.4.2.7 

ground  level 
CSU  8.6.4.2.8 

DC 

agl  to  abs  altitude  'N 

CSU  8.6  4.2.9  J 

r  -  --  I . . .  I - —  ••  I _ 

r  dir_to  tan_point 

V  CSU  8.6.4.2.10 

waypoint  ve* 
CSU  8.6.4.2  (1 

DC 

orbit  velocity  N 

CSU  8.6.4.2.12  ) 

I 

■  "1  ~ 

r  2  velocity 

V  CSU  8.6.4.2.13 

3C 

combined  velocity  'N  f 

CSU  8.6.4.2.14  J  V 

pilot  on  same  route  ^ 
CSU  8.6.4.2T15  J 

"  i:"':' . 

— - - 

"  1 

r  pilotJs_facing_direction 
V  CSU  8.6.4.2.16 

"N  f  vehicle  facing_point  'N  ( 
J  V  CSU  8.6.4.2.17  J  V 

are  we  there  \ 

CSU  8.6.4.2.18  J 

.j.  ._  .. 

1  ~ 

■  ■  1 

r  xy  dir  and  range 

V  CSU  8.6.4.2.19 

3C_ 

compute  situation  'N  f 

CSU  8.6.4.2.20  J  V 

project_point  ^ 

CSU  8.6.4.2.21  J 

"T  ■  ■■ 

■ — ~T - 

1 

r  vec2  rotate 

V  CSU  8.6.4.2.22 

^  r  get  next  circle jx>int  A  f 
J  V  CSU  8.6.4.2.23  J  V 

pilot  start  takingoff  ^ 

CSU  8.6.4.2.24  J 

r~  — . T  ■  - - - T- - - 1 _ 

r  pilot  takingoff 

V  CSU  8.6.4.2.25 

pilot  start_gotopoint  f 

CSU  8.6.4.2.26  J  V 

pitot_gotopoint  'N 

CSU  8.6.4.2.27  J 

'  .'"“T 

- 1 - 

"I 

r  pilot_goto  endpoint 

V  CSU  8.6.4.2.28 

pilot  hold 
CSU  8.6.4.2.29 

DC 

pilot  init  hoverhold  A 

CSU  8.6.4.2.30  J 

_ 

1 

I 

1 

\r  pilot  start  hoverhold 
fv  CSU  8.6.4.2.31 

)C 

pilot  hoverhold 
CSU  8.6.4.2.32 

DC 

pilot  hoverhold  tick  ^ 
CSU  8.6.4.2.33  ) 

Figure  2.6-12:  pilotc  CSC  Structure  Part  1  of  3 
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_ 

1 

1 

1 

r  pilot  init  orbithold 

V  CSU  8.6.4.2.34 

pilot  orbithold  ^ 

CSU  8.6.4.2.36  ) 

•  i 

- 1 - 

1 

f  pilot  orbit  tick 

V  CSU  8.6.4.2.37 

:)C 

pilot  racetrackhoid 
CSU  8.6.4.2.38 

DC 

pilot  init  land  'N 

CSU  8.6.4.2.39  J 

1 _ 

1 

1 

\ 

f  pilot  start  landing 

V  CSU  8.6.4.2.40 

pilot  landing 

CSU  8.6.4.2.41 

DC 

pilot  start  landed  'N 

CSU  8.6.4.2.42  J 

1 

1 

1 

f  pilot  landhold  tick 

V  CSU  8.6.4.2.43 

pilot  init  followroute 
CSU  8.6.4.2.44 

DC 

pibt  followroute  tick 

CSU  8.6.4.2.45  J 

1 

1 

_ 1 _ 

pilot_start_hoverattack_ 
approach  CSU  8.6.4.2.47 

A  f  pilot  hoverattack  approacInN 
y  V  CSU  8.6.4.2.48  ) 

- 1 - 

1  . 

- 1 

r  pilot  start  hoverattack 
V  CSU  8.6.4.2.49 

pilot_point_atjlarget 
CSU  8.6.4.2.50 

DC 

pilot  hoverattack 

CSU  8.6.4.2.51  y 

r 

1 

_ 1 _ 

A  pilot_start_hoverattack_ 
V  egress  CSU  8.6.4.2.52 

pilot_start_hovarattack_ 
complete  CSU  8.6.4.2.52 

’N  f  pilot  hoverattack  complete'N 
y  V  CSU  8.6.4.2.54  J 

t  .  1 - - - -  1  - -  ~  1 _ 

f  pilot  hoverattack  tick 
V  CSU  8.6.4.2.55 

DC 

pilot  follow  vehicle 
CSU  8.6.4.2.56 

DC 

pilot  lollowvehicle  'N 
CSU  8.6.4.2.57  J 

1 

1 

1 

r  pilot  face  direction 

V  CSU  8.6.4.2.58 

DC 

pilot  tick2 

CSU  8.6.4.2.59 

DC 

idle_tick  ^ 

CSU  8.6.4.2.60  J 

1 

1 

1 

r  attackatwill  tick 

V  CSU  8.6.4.2.61 

DC 

attackatwill  tick  new 
CSU  8.6.4.2.62 

DC 

pilot_check_state 

CSU  8.6.4.2.63  ) 

_ 

1 

1 

1 

1  f  pilot  tick 

IV  CSU  8.6.4.2.64 

DC 

pilot_get  altitude 
CSU  8.6.4.2.65 

DC 

pilot  change  altitude  ^ 

im  CSU  8.6.4.2.66  ) 

Figure  2.6-13:  pilot.c  CSC  Structure  Part  2  of  3 
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T 


1 

1 

1 

^  pilot_get  speed 

pilot  change  speed  im 

:>c 

pilot_goto_point  im  A 

V  CSU  8.6.4.2.67 

CSU  8.6.4.2.68 

CSU  8.6.4.2.69  J 

■  ■  r 

-| 

LI 

A  pilot  land  im 

V  CSU  8.6.4.2.70 

JC 

pilot  cancel  immediate 
CSU  8.6.4.2.71 

mmmmmm 

_ 

1 

I 

1 

^  pilot  follow  vehicle  im 
^  CSU  8.6.4.2.73 

3C 

pilot  face  direction  im 
CSU  8.6.4.2.74 

3C 

pilot  hoverattack  im  'N 
CSU  8.6.4.2.75  J 

r 

■  ■  1 

^  pilot  hold  im 

JC 

pilot  mission  completed 

pilot  stationpoint  A 

V  CSU  8.6.4.2.76 

CSU  8.6.4.2.77 

CSU  8.6.4.2.78  J 

_ =11 _ 1. 

1 

1 

pilot  follow  leader 

pilot_set_route  mis  A 

CSU  8.6.4.2.80 

CSU  8.6.4.2.81  J 

- 1 - 

. 1  . 

-\ 

^  pilot  stop  mission 

)C 

pilot  set  speed  mis 

:)C 

pilot_get  asm  'N 

V  CSU  8.6.4.2.82 

CSU  8.6.4.2.83 

CSU  8.6.4.2.84  J 

1 

Cpilot_exacute_overlay 
CSU  8.6.4.2.85 


)  Figure  2.6-14;  pilot.c  CSC  Structurepart  3  of  3 
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2. 6. 4. 2.1  pilot_state_to_string  CSU 


Parameters 


Parameters 


state 


Return  Value 


hover  hold 


ortHt  hold 


"race  track  hold” 


land  hold 


"follow  route" 


hover  attack 


"runnina  attack 


"follow  vehicle" 


"follow  leader" 


"face  direction 


landed 


Bakina  off 


o  to 


"complete" 


landin 


eoress" 


"fomation  hover" 


"unknown  state" 


f!S 

1 13 
113 


113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 

113 


ReturnVaiues 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


htertochar 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  char 


Where  Tvoedef  Declared 


Standard 


Meanin 


Pilot  idle. 


Pilot  hokfino  in  a  hover. 


Pilot  hoidino  in  a  circle. 


Pilot  holding  in  a  race  track 
pattern. 


Pilot  hoidino  by  landi 


Pilot  followina  a  route. 


Pilot  attackino  while  hoverin 


Pilot  attackino  while  movin 


Pilot  followino  vehicle. 


Pilot  followino  leader. 


Pilot  turnin 


Pilot  landed. 


Pibt  takino  off. 


Pilot  ooino  fo  a  point. 


Pilot  mission  complete. 


Pilot  landi 


Pilot  executino  approach. 


Pilot  breakino  off  hover  attack. 


Pilot  hovenno  in  formation. 


Pilot  state  unknown. 


Table  2.6-136:  pilot_state_to_string  CSU  [8.6.4.2.1] 


2. 6. 4. 2. 2  create_pilot  CSU 

This  CSU  creates  a  pilot. 
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1  Calls  1 

Function 

Where  Described 

allocate  pilot 

Sec.  2.9. 1.2  See  Appendix  A 

init  pilot  state  machine 

Sec.  2.6.4.2.3 

vec  copy 

Sec.  2. 

vec  init 

Sec.  2. 

Table  2.6-137:  create_pilot  CSU  [8.6.4.2.2] 


2. 6. 4. 2. 3  init_pilot_state_machine  CSU 


This  CSU  initializes  the  pilot  state  machine. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

int 

Standard 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Aircraft  type  is  neither  a  helicopter  nor  a  plane. 

1  Calls  1 

Function 

Where  Described 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

vec  set 

Sec.  2.6.3.2.36 

Table  2.6-138:  init_pilot_state_machine  CSU  [8.6.4.2.3] 


2. 6. 4. 2. 4  destroy_pilot  CSU 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

•pilot 

pointer  to  PILOT VARS 

Calls 

Function 

Where  Described 

deallocate  pilot 

Sec.  2.9. 1.2  See  Appendix  A 

Table  2.6-139:  destroy_pilot  CSU  [8.6.4.2.4] 


2. 6. 4. 2. 5  pilot_remove_vehicles  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•pilot 

pointer  to  PILOT  VARS 

Sec.  2.9.1. 2 

num 

int 

Standard 

V  listfl 

unsiqned  int 

Standard 
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1  Calls  1 

Function 

Where  Described  1 

LOOKUP  SAFOBJ 

Table  2.6-140:  pnot_remove_vehicIes  CSU  [8.6.4.2.5] 


2. 6. 4. 2. 6  pilot_show_machme  CSU 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

pilot  state  to  strinq 

Sec.  2.6.4.2.1 

print  vector 

Sec.  2.14.3.5.2 

Table  2.6-141:  pilot_show_machine  CSU  [8.6.4.2.6] 


2. 6. 4. 2. 7  pilot_show  CSU 


I  Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

•pilot 

pointer  to  PILOT  VARS 

Sec.  2.9.1. 2 

flags 

int 

Standard 

Calls 

Function 

Where  Described 

pilot  show  machine 

Sec.  2.6.4.2.6 

print  vector 

Sec.  2.14.3.5.2 

Table  2.6-142:  pilot_show  CSU  [8.6.4.2.7] 


2. 6. 4. 2. 8  groundjevel  CSU 

This  CSU  determines  the  elevation  above  mean  sea  level  at  the  specified  position. 


Parameters 


Parameters 


sition 


extend 


VECTOR 


int 


Where  Tvoedef  Declared 


sim  t 


Standard 


ReturnValues 


Return  Value 


vtem 


e 


REAL 


Meanin 


Elevation  above  msl. 
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1  calls  1 

1  Function 

Where  Described 

Sec.  2.14.1.2.5 

vec2  copy 

Sec.  2.14.3.5.29 

tdb  qet  ql 

Sec.  2.14.1.2.2 

Table  2.6-143:  ground_level  CSU  [8.6.4.2.8] 


2. 6. 4. 2. 9  agI_to_abs_altitude  CSU 


This  CSU  converts  height  above  ground  at  the  specified  position  to  absolute  altitude. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

position 

VECTOR 

Sim  types. h 

aol 

REAL 

Sim  types.h 

1  Return  Values  1 

1  Return  Value 

Type 

Meaninq 

REAL 

Absolute  attitude. 

1  Calls  1 

■  Function 

Where  Described 

Sec.  2.14.1.2.5 

1  tdb  qet  ql 

Sec.  2.14.1.2.2 

Table  2.6-144:  aglJo_abs^aItitude  CSU  [8.6.4.2.9] 


2.6.4.2.10  dir_to_tan_point  CSU 

This  CSU  determines  the  direction  from  a  point  to  a  tangent  point  on  a  circle.  It  returns 
TRUE  if  startt  is  outside  the  circle  and  point  is  valid,  FALSE  otherwise. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

center 

VECTOR 

Sim  types.h 

start 

VECTOR 

Sim  types.h 

point 

VECTOR 

Sim  types.h 

radius 

REAL 

Sim  types.h 

radius2 

REAL 

Sim  types.h 

dtopoint 

REAL 

Sim  types.h 

1  ReturnVaiues  1 

Return  Value 

Meaninq 

TRUE 

int 

start  is  outside  circle  and  point 
is  valid. 

FALSE 

int 

start  is  not  outside  circle  or 
point  \s  invalid. 
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Table  2.6-145;  dir_toJan_point  CSV  [8.6.4.2.10] 


2.6.4.2.11  waypoint_vel  CSU 


This  multipurpose  CSU  determines  if  the  current  waypoint  has  been  reached,  or  if  it  cannot 
be  reached.  In  either  case  it  returns  TRUE.  If  there  is  still  a  chance  of  getting  closer  to  a 
point  it  returns  FALSE  and  changes  the  desired  velocity  appropriately. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

•point 

REAL 

Sim  types. h 

ReturnValues 

Return  Value 

Type 

Meaning 

TRUE 

int 

Waypoint  either  has  been  or 
cannot  be  reached. 

FALSE 

int 

Waypoint  can  be  approached 
more  closelv. 

Calls 

Function 

Where  Described 

within  delta 

Sec.  2.14.1.2.10 

vec2  scale 

Sec.  2.14.3.5.28 

pilot  qet  speed 

Sec.  2.6.4.2.67 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  maa2 

Sec.  2.14.3.5.27 

interior_angle_between_vect 

ors 

Sec.  2.14.3.5.8 

vec2  norm 

Sec.  2.14.3.5.31 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

Table  2.6-146:  waypoint_vel  CSV  [8.6.4.2.11] 
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2.6.4.2.12  orbit_velocity  CSU 

This  CSU  calculates  the  velocity  to  go  around  a  circle.  A  positive  orbit  speed  gives 
counterclockwise  turns. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6  4.7 

Calls 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  maQ2 

Sec.  2.14.3.5.27 

vec2  set 

Sec.  2.14.3.5.21 

vec2  norm 

Sec.  2.14.3.5.31 

vec2  scale 

Sec.  2.14.3.5.28 

DEBUG  PILOT 

Sec.  2.5.2.2 

vec2  rot90 

Sec.  2.14.3.5.32 

vec2  add 

Sec.  2.14.3.5.22 

Table  2.6-147:  orbit_velocity  CSU  [8.6.4.2.12] 


2.6.4.2.13  z^velocity  CSU 

This  CSU  calculates  the  Z  velocity  to  maintain  an  altitude  above  ground  level. 


Parameters 


safobi 


*asm 


altitude 


m 

IIS 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


REAL 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Sim  t 


Function 


Calls 


Where  Described 


Sec.  2.13.3.5  See  A 


ndix  A 


abs 


max 


vec2  scale 


tdb  aet  zl 


vec  add 


noa  dam 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  A 


ndix  A 


Sec.  2.14.3.5.28 


Sec.  2.14.1.2.5 


Sec.  2.14.1.2.3 


Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 


Sec.  2.14.1.2.7 


ndix  A 


Table  2.6-148:  z_velocity  CSU  [8.6.4.2.13] 
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2.6.4.2.14  combined_velocUy  CSU 


This  CSU  resolves  the  desired  xy  and  z  velocities  to  get  a  combined  velocity. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

Calls 


Function 

Where  Described 

vec_maa3 

sim_macros.h 

Table  2.6>149:  combined^velocity  CSU  [8.6.4.2.14] 


2.6.4.2.15  pilot_on_same_route  CSU 

This  CSU  determines  if  another  pilot  is  on  my  route.  If  his  point  is  found  on  the  route  out 
from  my  point,  the  number  of  points  ahead  or  behind  is  placed  in  num _pnt  ahead  and 
TRUE  is  returned.  The  route  can  be  the  same  but  his  point  may  not  be  found  if  points  were 
added  to  the  route  after  the  route  started. 


I  Parameters  I 

Parameters 

Where  Tvoedef  Declared 

*mv  point 

pointer  to  ROUTEPOINT 

Sec.  2.10.2.5 

*his  point 

pointer  to  ROUTEPOINT 

Sec.  2.10.2.5 

•num  pnt  ahead 

int 

Standard 

1  ReturnVaiues  I 

Return  Value 

Meaning 

TRUE 

int 

Other  pilot  on  same  route. 

FALSE 

int 

Other  pilot  not  on  same  route. 

Table  2.6<150:  pilot_oii_saine_route  CSU  [8.6.4.2.15] 


2.6.4.2.16  pilot_is_facing_direction  CSU 


This  CSU  returns  TRUE  if  the  pilot  is  facing  direction  within  the  error  allowed. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobj 

pointer  to  SAP  OBJECT 

Sec.  2.91.1 

direction 

VECTOR 

Sim  tvpes.h 

error  allowed 

REAL 

Sim  types. h 

1  ReturnVaiues  I 

Return  Value 

Type 

Meaning 

VEC_SMALLER2(...) 

int 

If  TRUE,  pilot  is  facing  the 
direction  specified. 
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1  Calls  1 

Function 

Where  Described 

vec2  COPY 

Sec.  2.14.3.5.29 

OBJ  DIRECTION 

1  1  1  II  ■  1— 

vec2  sub 

Sec.  2.14.3.5.23  1 

VEC  SMALLER2 

Table  2.6-151:  piIot_is_facing_direction  CSU  [8.6.4.2.16] 


2.6.4.2.17  vehicle_facing_point  CSU 

This  CSU  determines  if  the  vehicle  is  facing  the  point,  that  is,  not  turning  toward  it . 


Parameters 


Parameters 


safobi 


01  nt 


lltS 


inter  to  SAP  OBJECT 


VECTOR 


Where  Tvoedef  Declared 


Sec.  2.91.1 


Sim  t 


Return  Value 


pilot_isJacing_direction(...) 


IBT! 


ReturnValues 


Meanin 


If  TRUE,  pilot  is  facing  the 
oint. 


Calls 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

OBJ  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

vec2  norm 

Sec.  2.14.3.5.31 

pilot  is  facing  direction 

Sec.  2.6.4.2.16 

Table  2.6-152:  vehicle_facing_point  CSU  [8.6.4.2.17] 


2.6.4.2.18  are  we  there  CSU 


This  CSU  determines  if  a  vehicle  has  arrived  at  a  specified  point. 
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1  Calls  1 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  mag2 

Sec.  2.14.3.5.27 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

pilot  init.land 

Sec.  2.6.4.2.39 

Table  2.6*153:  are_we_there  CSU  [8.6.4.2.18] 
2.6.4.2.19  xy_dir_and_range  CSU 


This  CSU  deteraiines  the  xy  direction  and  range  of  p.  It  assumes  that  p  has  pos.cur, 
pos_ref,  and  epsilon2  set. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

12 

pointer  to  XYZ 

Sec.  2.6.4.7 

1  ReturnVaiues  1 

Return  Value 

Meaning 

TRUE 

int 

Range  is  less  than  the  allowed 
epsilon. 

FALSE 

int 

Range  is  greater  than  the 
allowed  epsilon. 

1  Calls  1 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  scale 

Sec.  2.14.3.5.28 

Table  2.6-154:  xy_dir_and_range  CSU  [8.6.4.2.19] 


2.6.4.2.20  compute_situation  CSU 
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Table  2.6-155:  compute_situation  CSU  [8.6.4.2.20] 


2.6.4.2.21  project_point  CSU 


Parameters 


headooint 


distance 


newDOint 


Parameters 


inter  to  REAL 


inter  to  REAL 


REAL 


inter  to  REAL 


11:5 


Where  Tvoedef  Declared 


sim  t 


Sim  t 


stmi  tvoes.h 


Sim  t 


Return  Value 


TRUE 


FALSE 


idt: 


ReturnValues 


Meanin 


Direction  and  range  are 
withino  the  allowed  eosilon. 


Direction  and  range  are  not 
within  the  allowed  epsilon. 


Function 


vec2  CO 


XV  dir  and  ranoe 


vec2  scale 


vec2  add 


Calls 


Where  Described 


Sec.  2.14.3.5.29 


Sec.  2.6.4.2.19 


Sec.  2.14.3.5.28 


Sec.  2.14.3.5.22 


Table  2.6-156:  project_point  CSU  [8.6.4.2.21] 


2.6.4.2.22  vec2  rotate  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

costheta 

REAL 

Sim  types.h 

sintheta 

REAL 

Sim  types.h 

•v 

pointer  to  REAL 

Sim  types.h 

*r 

pointer  to  REAL 

sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec2  copy 

Sec.  2.14.3.5.29 

Table  2.6-157:  vec2_rotate  CSU  [8.6.4.2.22] 


273 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSC 


2.6.4.2.23  get_next_circle_point  CSU 


This  CSU  determines  the  next  circle  point 


1  Parameters  1 

1  Parameters  1 

Type 

Where  Typedef  Declared 

UuiV 

pointer  to  REAL 

Sim  tvpes.h 

•center 

pointer  to  REAL 

sim.tvpes.h 

radius 

REAL 

Sim  tvpes.h 

•point 

pointer  to  REAL 

Sim  tvpes.h 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

Direction  and  range  are 
withinq  the  allowed  epsilon. 

FALSE 

int 

Direction  and  range  are  not 
within  the  allowed  epsilon. 

1  Calls  1 

Function 

Where  Described 

vec2  copy 

Sec.  2.14.3.5.29 

XV  dir  and  range 

Sec.  2.6.4.2.19 

vec2  scale 

Sec.  2.14.3.5.28 

vec2  rotate 

Sec.  2.6.4.2.22 

vec2  add 

Sec.  2.14.3.5.22 

'Table  2.6-158:  get_next_circle_point  CSU  [8.6.4.2.23] 


2.6.4.2.24  pilot_start_takingoff  CSU 
This  CSU  causes  an  air  vehicle  to  take  off. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Pilot  type  is  neither  a  helicopter  nor  a  plane. 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

ground  level 

Sec.  2.6  4.2.8 

vec  set 

Sec.  2.6.3.2.36 

pilot  start  gotopoint 

Sec.  2.6.4.2.26 

Table  2.6-159:  pilot_start_takingoff  CSU  [8.6.4.2.24] 
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2.6.4.2.25  pilot_takingoff  CSU 


This  CSU  returns  TRUE  if  an  air  vehicle  is  taking  off  and  returns  FALSE  otherwise. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobi 

DOinter  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  ReturnValues  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

air  vehicle  takino  off 

FALSE 

int 

not  takinq  off 

1  Calls  1 

Function 

Where  Described 

vec  set 

Sec.  2.6.3.2.36 

Table  2.6-160:  pilotjakingoff  CSU  [8.6.4.2.25] 


2.6.4.2.26  pilot_start_gotopoint  CSU 

This  CSU  causes  an  air  vehicle  to  go  to  a  specified  point. 


1  Parameters  I 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

•point 

pointer  to  REAL 

simjypes.h 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

OBJ  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

compute  situation 

Sec.  2.6.4.2.20 

vec2  copy 

Sec.  2.14.3.5.29 

Table  2.6-161:  pilot_start_gotopoint  CSU  [8.6.4.2.26] 


2.6.4.2.27  pilot_gotopoint  CSU 

This  CSU  returns  TRUE  if  an  air  vehicle  has  reached  a  specified  point  and  returns  FALSE 
otherwise. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

speed 

REAL 

Sim  types.h 

altitude 

REAL 

Sim  types.h 
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ReturnValues 


Return  Value 


TRUE 


FALSE 


Meanin 


Reached  or  passed  the  point. 


Not  there  vet. 


Calls 

Function 

Where  Described 

pjollowerjeader .passed jp 
oint 

Sec.  2.6.4.3.14 

OBJ  POSITION 

Sec.  2.9.1 .1  See  Appendix  A 

compute  situation 

Sec.  2.6.4.2.20 

vec2  dot 

Sec.  2.14.3.5.24 

vec2  scale 

Sec.  2.14.3.5.28 

Sec.  2.6.4.2.13 


Sec.  2.6.4.2.14 


Table  2.6-162:  pilot_gotopoint  CSU  [8.6.4.2.27] 
2.6.4.2.28  pilot_goto_endpoint  CSU 

This  CSU  returns  TRUE  if  the  vehicle  is  at  an  endpoint  and  returns  FALSE  otherwise. 


Parameters 


*safobj 


•asm 


speed 


altitude 


decel 


lEST? 
irs 
irs 


Parameters 


inter  to  SAF  OBJECT 


inter  to  A»R  SM 


REAL 


REAL 


REAL 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Sim  t 


sim  t 


Sim  t 


Return  Value 


TRUE 


FALSE 


IBT] 


ReturnValues 


At  endpoint. 


Not  at  endpoint. 


Calls 

Function 

Where  Described 

compute  situation 

Sec.  2.6.4.2.20 

vec2  dot 

Sec.  2.14.3.5.24 

min 

vec2  scale 

I  Sec.  2.14.3.5.28 

Sec.  2.6.4.2.13 


Sec.  2.6.4.2.14 


Table  2.6-163:  pilot_goto_endpoint  CSU  [8.6.4.2.28] 
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2.6.4.2.29  pilot_hold  CSU 


Parameters 


Error  Name 


ERROR  ABORT 


Function 


ilot  init  hoverhold 


ilot  init  orbithold 


Parameters 


inter  to  SAF  OBJECT 


inter  to  AIR  SM 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Standard 


Errors 


Reason  for  Error 


Hold  tvoe  is  neither  hover,  racetrack,  nor  orbit. 


Calls 


Where  Described 


Sec.  2.6.4.2.30 


Sec.  2.6.4.2.34 


Table  2.6-164:  pilot_hold  CSU  [8.6.4.2.29] 


2.6.4.2.30  pilot_init_hoverhold  CSU 


Parameters 


•safobi 


•asm 


ID71! 

m 
irs 


Parameters 


inter  to  SAF  OBJECT 


inter  to  AIR  SM 


int 


REAL 


REAL 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Standard 


Sim  types.h 


Sim  types.h 


Function 


ilot  start  ootopoint 


not  start  hoyerhold 


Calls 


Where  Described 


Sec.  2.6.4.2.26 


Sec.  2.6.4.2.31 


Table  2.6-165:  pilot_init_hoverhold  CSU  [8.6.4.2.30] 


2.6.4.2.31  pilot_start_hoverhold  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

pilot  hoverhold 

Sec.  2.6.4.2.32 

Table  2.6-166:  pilot_start_hoverhold  CSU  [8.6.4.2.31] 
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2.6.4.2.32  pilot_hoverhold  CSU 


Parameters 


safobi 


asm 


Parameters 


I  DOinter  to  SAP  OBJECT 


DOinter  to  AIR  SM 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Function 


OBJ  VELOCITY 


ilot  is  facino  direction 


vec  init 


Calls 


Where  Described 


endix  A 


Sec.  2.6.4.2.16 


Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 


Sec.  2.6.4.2.13 


Table  2.6*167:  pilot_hoverhold  CSU  [8.6.4.2.32] 


2.6.4.2.33  pilot_hoverhold_tick  CSU 


Parameters 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


Value  in  asm->sstate  is  none  of  the  expected  states. 


Function 


Ilot  start  takingoff 


ilot  takingoff 


ilot  start  gotopoint 


ilot  goto  endpoint 


ilot  get  speed 


ilot  start  hoverhold 


ilot  hoverhold 


Calls 


Where  Described 


Sec.  2.6.4.2.24 


Sec.  2.6.4.2.25 


Sec.  2.6.4.2.26 


Sec.  2.6.4.2.28 


Sec.  2.6.4.2.67 


Sec.  2.6.4.2.31 


Sec.  2.6.4.2.32 


Table  2.6*168:  pilot_hoverhold_tick  CSU  [8.6.4.2.33] 
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1  Calls  1 

1  Function 

Where  Described 

■  Pilot  start  aotopoint 

Sec.  2.6.4.2.26 

Table  2.6-169:  pilotJnit_orbithold  CSU  [8.6.4.2.34] 


2.6.4.2.35  pilot_start_orbithold  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6-170:  pilot_start_orbithold  CSU  [8.6.4.2.35] 


2.6.4.2.36  pilot_orbithold  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

aet  next  circle  point 

Sec.  2.6.4.2.23 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

vec2  copy 

Sec.  2.14.3.5.29 

xy  dir  and  ranoe 

Sec.  2.6.4.2.19 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

Sec.  2.6.4.2.13 

1  combined  velocity 

Sec.  2.6.4.2.14 

Table  2.6-171:  pilot_orbithold  CSU  [8.6.4.2.36] 


2.6.4.2.37  pilot_orbit_tick  CSU 


Parameters 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 
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1  Errors  1 

■  Error  Name 

Reason  for  Error 

1  ERROR  ABORT 

The  value  of  asm->sstate  is  none  of  the  expected  states. 

Calls 

Function 

Where  Described 

Dilot  start  takingoff 

Sec.  2.6.4.2.24 

pilot  takingoff 

Sec.  2.6.4.2.25 

pilot  start  gotopoint 

Sec.  2.6.4.2.26 

pilot  gotopoint 

Sec.  2.6.4.2.27 

pilot  get  speed 

Sec.  2.6.4.2.67 

pilot  start  orbithold 

Sec.  2.6.4.2.35 

pilot  orbithold 

Sec.  2.6.4.2.36 

Table  2.6-172:  pilot_orbit_tick  CSU  [8.6.4.2.37] 


2.6.4.2.38  pilot_racetrackhold  CSU 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

•pilot 

pointer  to  PILOT  VARS 

Sec.  2.9.1. 2 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4. 7 

Table  2.6-173:  pilot^racetrackhold  CSU  [8.6.4.2.38] 


2.6.4.2.39  piloMnItJand  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

X 

REAL 

Sim  types. h 

1 

REAL 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

INSIDE  BOX2 

Sec.  2.6.4.7  See  Appendix  A 

DEBUG  PILOT 

1— III^B 

pilot  start  gotopoint 

Sec.  2.6.4.2.26  1 

Table  2.6-174:  pilotjnitjand  CSU  [8.6.4.2.39] 
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2.6.4.2.40  piloMtartJanding  CSU 

Parameters 


safobi 


*asm 


ir: 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


Pilot  type  IS  neither  helicopter  nor  plane. 


Function 


DEBUG  PILOT 


vec  init 


ilot  start  landed 


Calls 


Where  Described 


endix  A 


Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 


Sec.  2.6.4.2.42 


Table  2.6-175:  piIot_starManding  CSU  [8.6.4.2.40] 


2.6.4.2.41  piloManding  CSU 


Parameters 


Parameters 


*safobi 


•asm 


IBT^] 
ir 
irs 


ointer  to  SAF  OBJECT 


inter  to  AIR  SM 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Return  Value 


TRUE 


FALSE 


lEiT] 


ReturnValues 


Meanin 


Chopper  altitude  agl  <==  model 
base  adjustment. 


Anvthino  else. 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


Pilot  type  is  other  than  helicopter . 


Function 


vec  set 


Calls 


Where  Described 


Sec.  2.6.3.2.36 


Table  2.6-176:  piloManding  CSU  [8.6.4.2.41] 


2.6.4.2.42  pilot_starManded  CSU 


Parameters 


Parameters 


asm 


inter  to  SAF  OBJECT 


inter  to  AIR  SM 


Where  Tvpedef  Declared 


Sec.  2. 9. 1.1 


Sec.  2.6.4.7 
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Errors 

Error  Name 

Reason 

for  Error 

ERROR  ABORT 

is  neither  helicopter  nor  plane. 

Function 


round  level 


vec  init 


DEBUG  PILOT 


coords  within  database 


tdb  Diace  vehicle 


s  atan2 


report  error  from  tdb  once 


mat  rot  init 


Calls 


Where  Described 


Sec.  2.6.4.2.8 


Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 


Sec.  2.Sec.  2.5.2.2  See  Apoendix  A 


ndix  A 


Sec.  2.21.7.20.5 


ndix  A 


Sec.  2.14.1.2.4 


Sec.  2.6.2.47.1  Vehicles  CSCI  SDD 


Table  2.6-177:  pilot_starManded  CSU  [8.6.4.2.42] 
2.6.4.2.43  pilotjandholdjick  CSU 


Parameters 


*safobi 


asm 


Parameters 


Type 


pointer  to  SAP  OBJECT 


pointer  to  AIR  SM 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


Value  m  asm->sstate  is  none  of  the  expected  states. 


Function 


ilot  start  takinooff 


I  lot  takinooff 


ilot  start  ootopoint 


ilot  ooto  endpoint 


Ilot  oet  speed 


Ilot  start  landin 


Ilot  landin 


ilot  start  landed 


Calls 


Where  Described 


Sec.  2.6.4.2.24 


Sec.  2.6.4.2.25 


Sec.  2.6.4.2.26 


Sec.  2.6.4.2.28 


Sec.  2.6.4.2.67 


Sec.  2.6.4.2.40 


Sec.  2.6.4.2.41 


Sec.  2.6.4.2.42 


Table  2.6-178:  pilotjandholdjick  CSU  [8.6.4.2.43] 


2.6.4.2.44  pilotjnit Jollowroute  CSU 


Parameters 


safobi 


asm 


route 


routeooint 


Parameters 


I  pointer  to  SAF  OBJECT 


pointer  to  AIR  SM 


pointer  to  ROUTE 


pointer  to  ROUTEPOINT 


Where  Typedef  Declared 


Sec.  2.9.1 .1 


Sec.  2.6  4.7 


Sec.  2.10.2.5 


Sec.  2.10.2.5 
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Table  2.6-179:  piIot_init_foIlowroute  CSU  [8.6.4.2.44] 


2.6.4.2.45  pilot_followroute_tick  CSU 


Parameters 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


value  in  asm->sstate  is  none  of  the  expected  states. 


Function 


not  start  takinooff 


ilot  takinooff 


ilot  start  qotopoint 


not  qotopoint 


not  qet  speed 


follower  flip  in  turn 


ilot  init  huverhold 


■lot  init  orbithoid 


not  hoverhold 


Calls 


Where  Described 


Sec.  2.6.4.2.24 


Sec.  2.6.4.2.25 


Sec.  2.6.4.2.26 


Sec.  2.6.4.2.27 


Sec.  2.6.4.2.67 


Sec.  2.6.4.3.23 


Sec.  2.6.4.2.30 


Sec.  2.6.4.2.34 


Sec.  2.6.4.2.32 


Table  2.6-180:  pilot_folIowroute_tick  CSU  [8.6.4.2.45] 


2.6.4.2.46  pilot_init_hoverattack  CSU 
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Calls 

Function 

Where  Described 

vec2  set 

Sec.  2.14.3.5.21 

msi! 


Sec.  2.6.4.2.21 


Sec.  2.6.2.59.1  Vehicles  CSCI  SOD 


Sec.  2.14.3.5.29 


Sec.  2.6.4.2.26 


vec  CO 


(lot  start  ootoDOint 


Table  2.6>181:  pilot_init_hoverattack  CSU  [8.6.4.2.46] 


2.6.4.2.47  pilot_start_hoverattack_approach  CSU 


Parameters 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Function 


ilot  start  aotoooint 


DEBUG  PILOT 


Calls 


Where  Described 


Sec.  2.6.4.2.26 


Sec.  2.5.2.2  See  Appendix  A 


Table  2.6*182:  pilot_start_hoverattack_approach  CSU  [8.6.4.2.47] 


2.6.4.2.48  pUot_hoverattack_approach  CSU 


Parameters 


asm 


IEI7? 
IIS 

irs 


Parameters 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Return  Value 


TRUE 


PALSE 


idtt: 


ReturnValues 


Meanin 


Direction  and  range  are  within 
the  allowed  epsilon. 


Direction  and  range  are  not 
within  the  allowed  epsilon. 


Calls 


Where  Described 


Sec.  2.6.4.2.20 


Sec.  2.14.3.5.28 


Sec.  2.6.4.2.67 


Sec.  2.6.4.2.13 


Sec.  2.6.4.2.14 


Table  2.6*183:  pilot_hoverattack_approach  CSU  [8.6.4.2.48] 


Function 


compute  situation 


vec2  scale 


ilot  aet  speed 
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2.6.4.2.49  pilot_start_hoverattack  CSU 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

taroetina  set  fire  at  pointair 

Sec.  2.6.9.3.8 

Sec.  2.6.9.3.10 

Table  2.6-184:  pilot_start_hoverattack  CSU  [8.6.4.2.49] 


2.6.4.2.50  pilot_point_at_target  CSU 


1  Parameters 

Parameters 

Where  Typedef  Declared 

*sa1obi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

target  id 

unsigned  short 

Standard 

1  ReturnValues  I 

Return  Value 

Meaning 

TRUE 

int 

Locked  onto  target. 

FALSE 

int 

Unable  to  lock  onto  target. 

Calls 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

vec  sub 

Sec.  2.6.2.65.1  Vehicles  CSCI  SDD  ' 

vec2  dot 

Sec.  2.14.3.5.24 

vec2  maa2 

Sec.  2.14.3.5.27 

vec  COPY 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

Table  2.6-185:  pilot_point_atJarget  CSU  [8.6.4.2.50] 


2.6.4.2.51  pilot_hoverattack  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 
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Table  2.6-186:  pilot_hoverattack  CSU  [8.6.4.2.51] 
2.6.4.2.52  pilot_start_hoverattack_egress  CSU 


Parameters 


Parameters 


safobi 


Function 


Hot  Start  ootoDoint 


DEBUG  PILOT 


taroetina  set  hold  fire 


ESI!] 

e _ _ _ _ 

Where  Typedef  Declared 

£Q 

inter  to  SAF  OBJECT 

Sec.  2.9.1. 1 

DO 

inter  to  AIR  SM 

Sec.  2.6  4.7 

Calls 


Where  Described 


Sec.  2.6.4.2.26 


endix  A 


Table  2.6-187: 


Sec.  2.6.9.3.9 


pilot_start_hoverattack_egress  CSU  [8.6.4.2.52] 


2.6.4.2.53  pilQt_start_hoverattack_complete  CSU 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

Calls 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

pilot  hoverattack  complete 

Sec.  2.6.4.2.54 

Table  2.6-188:  pilot_start_hoverattack_complete  CSU  [8.6.4.2.53] 
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2.6.4.2.54  pilot_hoverattack_complete  CSU 


Parameters 


Parameters 


Where  Tvpedef  Declared 


*safobi 


pointer  to  SAP  OBJECT 


Sec.  2.9.1. 1 


*asm 


pointer  to  AIR  SM 


Sec.  2.6.4.7 


Calls 


Function 


Where  Described 


vec  init 


Sec.  2.6.2.61.1  Vehicles  CSC!  SDD 


^vejocit]^ 


Sec.  2.6.4.2.13 


Table  2.6-189:  pilot_hoverattack_complete  CSU  [8.6.4.2.54] 


2.6.4.2.55  pilot_hoverattack_tick  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Value  in  asm->sstate  is  none  of  the  expected  states. 

1  Calls  1 

Function 

Where  Described 

pilot  start  taklnooff 

Sec.  2.6.4.2.24 

pilot  takinqotf 

Sec.  2.6.4.2.25 

pilot  start  qotopoint 

Sec.  2.6.4.2.26 

pilot  qotopoint 

Sec.  2.6.4.2.27 

pilot  qet  speed 

Sec.  2.6.4.2.67 

pilot_start_hoverattack_appro 

ach 

Sec.  2.6.4.2.47 

pilot  qoto  endpoint 

Sec.  2.6.4.2.28 

pilot  start  hoverattack 

Sec.  2.6.4.2.49 

pilot  hoverattack 

Sec.  2.6.4.2.51 

pilot_start_hoverattack_egres 

s 

Sec.  2.6.4.2.52 

pilot_start_hoverattack_compl 

ete 

Sec.  2.6.4.2.53 

pilot  hoverattack  complete 

Sec.  2.6.4.2.54 

Table  2.6-190:  pilot_hoverattack_tick  CSU  [8.6.4.2.55] 
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2.6.4.2.56  pilot_follow_vehicle  CSU 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

‘asm 

OointertoAIR  SM 

Sec.  2.6.4.7 

vid 

unsiqned  int 

Standard 

xoff 

int 

Standard 

voff 

int 

Standard 

Table  2.6-191:  pnot_follow_vehicle  CSU  [8.6.4.2.56] 


2.6.4.2.57  pilot_followvehicle  CSU 


Parameters 


sition 


leadveh 


offset 


*safobi 


**forp 


forp dir 


Function 


et  unit  direction 


vec2  scale 


stationooint 


vec2  sub 


vec2  dot 


min 


vec2  add 


vec  scale 


vec  CO 


set  soeed  dir 


IE2T] 

m 

lIsS 


Parameters 


e 


VECTOR 


inter  to  SAF  OBJECT 


VECTOR 


pointer  to  SAF_OBJECT 


pointer  to  pointer  to 
ROUTEPOINT 


int 


Where  Tyoedef  Declared 


liHuli!]! 


Sec.  2.9.1. 1 


sim_types.h 


Sec.  2.9.1. 1 


Sec.  2.10.2.5 


Standard 


Calls 


Where  Described 


Sec.  2.6.3.2.11 


Sec.  2.14.3.5.28 


Sec.  2.6.3.2.10 


Sec.  2.14.3.5.23 


Sec.  2.14.3.5.24 


Sec.  2.13.3.5  See  A 


Sec.  2.14.3.5.22 


Sec.  2.6.3.2.5 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.61 .1  Vehicles  CSCI  SDD 


Sec.  2.6.3.2.6 


ndix  A 


Table  2.6-192:  pilotjollowvehicle  CSU  [8.6.4.2.57] 
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Table  2.6>193:  pilot_face_direction  CSU  [8.6.4.2.58] 


2.6.4.2.59  pilot_tick2  CSU 


Parameters 


Parameters 


safobi 


asm 


irs 


inter  to  SAP  OBJECT 


inter  to  AIR  SM 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Return  Value 


TRUE 


FALSE 


lElTi! 


ReturnVafues 


Meanin 


Pilot  state  idle  or  unknown. 


Pilot  state  not  idle  and  not 
unknown. 


Error  Name 


ERROR  ABORT 


Errors 


Reason  for  Error 


value  tn  asm->pstate  is  none  of  the  expected  states. 


Function 


ilot  hoverhold  tick 


ilot  orbit  tick 


ilot  landhold  tick 


ilot  followroute  tick 


ilot  follow  leader  tick 


ilot  hoverattack  tick 


Calls 


Where  Described 


Sec.  2.6.4.2.33 


Sec.  2.6.4.2.37 


Sec.  2.6.4.£  45 


Sec.  2.6.4.3.22 


Sec.  2.6.4.2.55 


Table  2.6-194;  pilot Jick2  CSU  [8.6.4.2.59] 


2.6.4.2.60  idle  tick  CSU 
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Table  2.6-195:  idle  tick  CSU  [8.6.4.2.60] 


2.6.4.2.61  attackatwill  tick  CSU 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

I  ReturnValues  I 

Return  Value 

Meanina 

TRUE 

int 

Riot  state  is  hover  attack, 
point  at  target  is  called,  and 
target  is  valid. 

FALSE 

int 

TRUE  condition  not  extant. 

I  Calls  I 

Function 

Where  Described 

RANGE  CLIP 

Sec.  2.14.3.9  See  Appendix  A 

Pilot  aet  speed 

Sec.  2.6.4.2.67 

Qunner  round  flvino 

Sec.  2.6.9.5.6 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

. . . . 

Sec.  2.6.4.2.13 

Table  2.6-196:  attackatwilljick  CSU  [8.6.4.2.61] 


2.6.4.2.62  attackatwill  tick  new  CSU 


_  Parameters 

Parameters  Type 

*safobi_ pointer  to  SAP  OBJECT 


_ _ ReturnValues 

Return  Value  I  Type 


Where  Tvoedef  Declared 


Sec.  2.9. 1.1 


Meanin 


TRUE 

int 

FALSE 

int 

_ _ Errors _ 

Error  Name  Reason  for  Error 

ERROR  ABORT  Value  in  Dilot->fireat  state  is  none  of  the  expected  states. 
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Function 


RANGE  CLIP 


Hot  oet  speed 


unner  round  flyin 


vec  scale 


Calls 


Where  Described 


ndix  A 


Sec.  2.6.4.2.67 


Sec.  2.6.9.5.6 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


Sec.  2.6.4.2.13 


Table  2.6-197:  attackatwilMick_new  CSV  [8.6.4.2.62] 


2.6.4.2.63  pnot_check_state  CSU 


Parameters 


safobj 


IDT!! 

irs 


Parameters 


e  Where  Typedef  Declared 


inter  to  SAP  OBJECT  Sec.  2.9.1 .1 


Function 


DEBUG  STATION 


OBJ  VEHICLEID 


Calls 


Where  Described 


Sec.  2.5.2.2  See  Appendix  A 


Sec.  2.9. 1.1  See  Appendix  A 


Table  2.6>198:  piIot_check_state  CSU  [8.6.4.2.63] 


2.6.4.2.64  pilotjick  CSU 


Parameters 


Function 


Hot  check  state 


attackatwill  tick 


not  tick2 


idle  tick 


vec  CO 


Parameters 


Where  Typedef  Declared 


inter  to  SAP  OBJECT  Sec.  2.9.1. 1 


Calls 


Where  Described 


Sec.  2.6.4.2.63 


Sec.  2.6.4.2.61 


Sec.  2.6.4.2.59 


Sec.  2.6.4.2.60 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Table  2.6-199:  pilotjick  CSU  [8.6.4.2.64] 


2.6.4.2.65  pilot_get_altitude  CSU 
This  CSU  returns  the  currently  used  altitude. 
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1  ReturnValues  1 

Return  Value 

Type 

Meaning 

safobi->pilot->im.altitude 

REAL 

Immediate  altitude. 

safobi->pilot->mis.altitude 

REAL 

Mission  altitude. 

Table  2.6*200:  pilot_get_altitude  CSU  [8.6.4.2.65] 


2.6.4.2.66  pilot_change_altitude_iin  CSU 
This  CSU  changes  the  pilot's  altitude  immediately. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

‘safobj 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

altitude 

REAL 

Sim  types.h 

int 

Standard 

Table  2.6*201:  pilot_change_altitude_im  CSU  [8.6.4.2.66] 


2.6.4.2.67  pilot_get_speed  CSU 


This  CSU  gives  the  cunently  used  speed. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

safobj->ain/eh->max_mps_ 

forward 

REAL 

Maximum  aibwed  forward 
soeed. 

safobj->airveh->min_mps_ 

forward 

REAL 

Minimum  aibwed  forward 
speed. 

speed 

REAL 

Current  speed. 

Table  2.6*202:  pilot_get_speed  CSU  [8.6.4.2.67] 


2.6.4.2.68  pilot_change_speed_im  CSU 
This  CSU  changes  the  pilot's  speed  immediately. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9. 1.1 

speed 

REAL 

Table  2.6*203:  pilot_change_speed_im  CSU  [8.6.4.2.68] 
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2.6.4.2.69  piIot_goto_point_im  CSU 


This  CSU  moves  the  airvehicle  to  a  point  immediately. 


1  Parameters 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

X 

REAL 

Sim  tvpes.h 

y 

REAL 

sim_types.h 

Errors 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Safobi  pitot  type  is  neither  a  helicopter  nor  a  plane. 

Calls 


Function 

Where  Described 

pilot  init  hoverhold 

Sec.  2.6.4.2.30 

Table  2.6-204:  pilot_goto_point_im  CSU  [8.6.4.2.69] 


2.6.4.2.70  piIot_land_im  CSU 


This  CSU  causes  the  pilot  to  land  immediately. 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

'safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

X 

REAL 

Sim  tvpes.h 

y 

REAL 

simjypes.h 

Calls 

Function 

Where  Described 

pilot  init  land 

Sec.  2.6.4.2.39 

Table  2.6-205:  pilot_land_im  CSU  [8.6.4.2.70] 


2.6.4.2.71  pilot_cancel_immediate  CSU 


This  CSU  puts  the  pilot  into  an  idle  state  immediately. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Table  2.6-206:  pilot_canceMmmediate  CSU  [8.6.4.2.71] 
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2.6.4.2.72  piIot_executing_immediate_command  CSU 
This  CSU  takes  the  pilot  out  of  the  idle  state  immediately. 


Parameters 

•pilot 


Parameters 

Dtfifi _ 

pointer  to  PILOT  VARS 


Where  Typedef  Declared 


Return  Value 

pilot->im.pstate  1= 


im 

int 


ReturnVaiues _ 

[Meaning 

Pilot  state  set  to  not  idle. 


PSTATE  iPLE 


Table  2.6*207:  pilot_executing_iinmedIate_coinmand  CSU  [8.6.4.2.72] 


2.6.4.2.73  pilot_foIlow_vehicle_im  CSU 
This  CSU  has  a  pilot  immediately  follow  a  vehicle. 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

vid 

unsigned  int 

Standard 

xoff 

int 

Standard 

yoff 

int 

Standard 

Calls 

Function 

Where  Described 

pilot  follow  vehicle 

Sec.  2.6.4.2.56 

Table  2.6-208:  pilot_follow_vehicle_im  CSU  [8.6.4.2.73] 


2.6.4.2.74  pilot_face_direction_im  CSU 

This  CSU  has  the  pilot  immediately  face  in  a  specified  direction. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

mathradians 

REAL 

Sim  tvpes.h 

Calls 

Function 

Where  Described 

pilot  face  direction 

Sec.  2.6.4.2.58 

Table  2.6-209:  pilot_face_direction_im  CSU  [8.6.4.2.74] 
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2.6.4.2.75  pilot_hoverattack_im  CSU 

This  CSU  initiates  an  immediate  hoverattack  by  the  pilot. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

popup  X 

REAL 

Sim  types.h 

popup_y 

REAL 

sim_types.h 

target_x 

REAL 

H 1 1 1 K  ifl 

target y 

REAL 

sim types.h  | 

1  Calls  1 

Function 

Where  Described  I 

pitot  init  hoverattack 

Sec.  2.6.4.2.46  ! 

Table  2.6-210:  pilot_hoverattack_im  CSU  [8.6.4.2.75] 


2.6.4.2.76  piIot_hoIdJm  CSU 
This  CSU  has  the  pilot  hold  immediately. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

pilot  hold 

Sec.  2.6.4.2.29 

Table  2.6-211:  pilot_hoId_im  CSU  [8.6.4.2.76] 


2.6.4.2.77  pilot_mission_completed  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•pilot 

pointer  to  PILOT  VARS 

Sec.  2.9.1. 2 

1  ReturnValues  1 

Return  Value 

Meanina 

TRUE 

int 

Mission  completed. 

FALSE 

int 

Mission  not  completed. 

Table  2.6-212:  pilot_niission_comp!eted  CSU  [8.6.4.2.77] 
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2.6.4.2.78  pilot_stationpoint  CSU 


Parameters 


Parameters 


•lot 


oint 


e? 

I? 


Return  Value 


TRUE 


FALSE 


Function 


stationooint 


irs 


inter  to  PILOT  VARS 


VECTOR 


Where  Tvpedef  Declared 


Sec.  2.9.1. 2 


Sim  t 


ReturnValues 


Meanin 


Success. 


Not  a  lead  vehicle. 


Calls 


Where  Described 


Sec.  2.6.3.2.10 


Table  2.6-213:  pilot_stationpoint  CSU  [8.6.4.2.78] 


2.6.4.2.79  pilot_seMeader_mis  CSU 


Parameters 


Parameters 


r 


vid 


X  offset 


'  offset 


inter  to  SAF  OBJECT 


unstoned  int 


int 


int 


Where  Typedef  Declared 


Sec.  2.9.1. 1 


Standard 


Standard 


Standard 


Errors 

Error  Name 

Reason  for  Error 

"pilot_setJeader_mis  called 
on  safobi  without  pilot” 

No  pilot. 

"Veh  ...  tokJ  to  follow 
nonexistent  vehicle” 

No  lead  vehicle. 

i 


Veh  ...  cannot  follow  itself 


This  vehicle  is  the  lead  vehicle. 


Function 


ERROR  OUT 


abort 


LOOKUP  SAFOBJ 


Calls 


Where  Described 


endix  A 


Sec.  2.9.1. 1  See  Appendix  A 


Table  2.6-214:  pilot_seMeader_mis  CSU  [8.6.4.2.79] 


2.6.4.2.80  pilot_follow_leader  CSU 


Parameters 


Parameters 


safobi  pointer  to  SAF  OBJECT 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 
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1  Errors  1 

Error  Name 

Reason  for  Error 

*pilot_setJeader_mis  called 
on  safobi  without  pHot” 

No  pilot. 

”Veh  ...  Unable  to  follow,  no 
leader" 

No  lead  vehicle. 

1  Calls  1 

Function 

Where  Described  I 

ERROR  OUT 

abort 

1 

Table  2.6-215:  pilot_followJeader  CSU  [8.6.4.2.80] 


2.6.4.2.81  piIot_set_route_mis  CSV 


1  Parameters 

Parameters 

Where  Typedef  Declared 

"safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

"route 

pointer  to  ROUTE 

Sec.  2.10.2.5 

"routepoint 

pointer  to  ROUTEPOINT 

Sec.  2.10.2.5 

1  Calls  1 

Function 

Where  Described 

pilot  cancel  immediate 

Sec.  2.6.4.2.71 

pilot  init  followroute 

Sec.  2.6.4.2.44 

Table  2.6-216:  pllot_set_route_mis  CSU  [8.6.4.2.81] 


2.6.4.2.82  pilot_stop_mission  CSU 


This  CSU  stops  the  mission  by  setting  the  state  idle. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

"safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

Table  2.6-217:  pilot_stop_inission  CSV  [8.6.4.2.82] 


2.6.4.2.83  pilot_set_speed_mis  CSU 
This  CSU  sets  the  mission  speed  to  speed. 


1  Parameters  1 

Parameters 

Type 

"safo^  i 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

speed 

REAL 

Sim  types. h 
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_ _ ReturnVaiues _ _ 

Return  Value  [Type  Meaning _ 

tsafobi->pilot->useimspeed  int  new  spe^ 

Table  2.6-218:  pilot_set_speed_inis  CSU  [8.6.4.2.83] 


2.6.4.2.84  pilot_get_asm  CSU 


Parameters _ _ 

Parameters  Type  Where  Typedef  Declared 

*leader_ pointer  to  SAF  .OBJECT_ Sec.  2.9.1. 1 


ReturnVaiues 


Return  Value 

Type 

Meanina 

&(leader->pilot->im) 

pointer  to  AIR  SM 

Immediate  asm. 

&(leader->pilot->mis) 

pointer  to  AIR  SM 

Mission  asm. 

Table  2.6-219:  pilot_get_asm  CSU  [8.6.4.2.84] 


2.6.4.2.85  pilot_execute_overlay  CSU 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

‘overtav 

pointer  to  OVERLAY 

Sec.  2.10.2.2 

*cm 

pointer  to 

CONTROL  MEASURE 

Sec.  2.10.2.2 

1  Errors  1 

Error  Name 

Reason  for  Error 

’Cannot  execute  anything  but 
route  cm" 

Control  measure  is  not  of  type  route. 

1  Calls  1 

Function 

Where  Described 

ERROR  OUT 

Sec.  2.5  2.2  See  Appendix  A 

pilot  set  route  mis 

Sec.  2.6.4.2.81 

Table  2.6-220:  pilot_execute_overlay  CSU  [?????] 
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2. 6. 4. 3  p_follower.c  CSC 
/simnet/src/host/p_follower.c 

This  CSC  contains  code  for  the  pilots  following  the  leader. 


Cp_followerjget_wrtd_offset A  A  pjollower_stop_coord  A  ^  p_follower_gen_coord_ 

CSU  8.6.4.3.7  J  V  CSU  8.6.4.3.8  J  V  goal  ont  CSU  8.6.4.3.9  J 

L 


_ .J- 

follower_set_follow 
CSU  8.6.4.3.10 


I 


DC 


p_follower_new_rel_rt_pnt 
CSU  8.6.4.3.11 


pJollower_flying_inde  N 
pendent  CSU  8.6.4.3.12  J 


follower_followroute 
CSU  8.6.4.3.13 


i_ticirS  C p  follower  teader  passed^  t  p_follower_passed_point  A 
_ J  V  point  CSU  8.6.4.3.14  J  V  CSU  8.6.4.3.15  J 


r  p  follower  hoverattack  tick’N  f  p  follower jgoto _pnt  coord'N  f  p  follower  hoverhold 

V  CSU  8.6.4.3.16  J  V  CSU  8.6.4.3.17  J  V  CSU  8.6.4.318 

- 1 - 

- 1 - 

- 1 

f  p  follower  land 

^  CSU  8.6.4.3.19 

A  ^  p  follower  landhokfjick 
V  CSU  8.6.4.3.20 

;  'N  f  p_follower_hoverhold  tick 
J  V  CSU  8.6.4.3.21 

'  1 . 

1 

1 

f  pilot_followJeader__tick 

\  r  p  follower  flip  in  turn 

A  ^  p  follower  find_pnt  in  turn" 

^  V  CSU  8.6.4.3.23 

^  V  CSU  8.6.4.3.24 

1  — 

\ 

1 

Figure  2.6-15:  p_folIower.c  CSC  Structure 


2. 6. 4. 3.1  p_follower_am_i_fIying_coord  CSU. 

This  CSU  returns  the  logical  OR  results  of  whether  goal  coordinate  points  are  set  for  the 
aircraft  to  determine  whether  a  plane  is  flying  independently  or  not. 


Parameters  | 

Type 

DO 


Parameters 

*asm _ 


>intertoAIR  SM 


Where  Typedef  Declared 

Sec.  2.6.47 _ 
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1  ReturnVaiues  1 

Return  Value 

Type 

Meaning 

(asm->coord _goal_pntlX])  || 
(asm->coord  ooal  pntfVI) 

int 

If  TRUE,  fHght  is  independent. 

Table  2.6*221:  p_foIlower_ain_i_flying_coord  CSU  [8.6.4.3.1] 


2. 6. 4. 3. 2  p_follow_form_fIip  CSU 

In  this  CSU  if  typejofjurn,  the  parameter  passed,  is  true  (-1),  this  is  returned,  indicating 
that  the  formation  X  positions  should  flip.  Otherwise  1  is  returned  and  no  flip  is  required 
because  there  is  no  turn. 


i  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

type  of  turn 

int 

Standard 

ReturnVaiues 

Return  Value 

Type 

Meaning 

type  of  turn  =  -1 

int 

Flip  formation  X  positions. 

1 

int 

No  flip  when  no  turn. 

Table  2.6*222:  p_foIlow_^form_flip  CSU  [8.6.4.3.2] 


2. 6. 4. 3. 3  p_foIlower_fly_in_coord_pos  CSU 

This  CSU  sets  the  follower  plane's  velocity  so  it  is  flying  its  correct  position  in  the 
formation  relative  to  the  leader's  plane. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

lead  vec 

VECTOR 

Sim  types.h 

lead  est  pos 

VECTOR 

Sim  types.h 

lead  vel 

REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec2  norm 

Sec.  2.14.3.5.31 

vec2  scale 

Sec.  2.14.3.5.28 

yec2  add 

Sec.  2.14.3.5.22 

p  follower  get  wrid  offset 

Sec.  2.6.4.3.7 

yec2  sub 

Sec.  2.14.3.5.23 

OBJ  POSITION 

Sec.  2.9. 1.1  See  Appendix  A 

Sec.  2.14.3.5.26 

Table  2.6-223:  p__foIlower_fly_in_coord_pos  CSU  [8.6.4.3.31 
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2. 6. 4. 3. 4  p_foUower_comp_reset_route  CSU 

This  CSU  resets  the  following  vehicles  of  a  composite  by  making  them  reaquire  the  route 
from  the  leader. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*composite 

pointer  to 

COMPOSITE  VARS 

Sec.  2.9.1. 2 

1  Calls  1 

Function 

Where  Described 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6*224:  p_folIower_comp_reset_route  CSU  [8.6.4.3.4] 


2. 6. 4. 3. 5  p_follower_arrive_at_same_time  CSU 


This  CSU  gets  the  following  vehicle  to  arrive  at  a  point  at  the  same  time  that  the  leader 
arrives  at  his  point. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*saf  object 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

lead  vec 

VECTOR 

Sim  tvoes.h 

lead  est  pos 

VECTOR 

Sim  types. h 

vec  to  aoal 

VECTOR 

Sim  tvpes.h 

1  Calls  1 

Function 

Where  Described 

vec2  maa 

Sec.  2.14.3.5.26 

pilot  qet  speed 

Sec.  2.6.4.2.67 

vec2  scale 

Sec.  2.14.3.5.28 

Table  2.6*225:  p_follower_arrive_at_same_time  CSU  [8.6.4.3.5] 


2. 6. 4. 3. 6  p_follower_set_desired_vel  CSU 

This  CSU  sets  the  velocity  of  the  following  vehicle  based  on  the  leader's  velocity. 
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Table  2.6*226:  p_folIower_set_desired_vel  CSU  [8.6.4.3.6] 

2. 6. 4. 3. 7  p_foIIower_get_wrld_offset  CSU 

This  CSU  calculates  the  offset  point  to  the  leader's  point. 


Table  2.6-227:  p_follower_get_wrld_offset  CSU  [8.6.4.3.7] 
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2. 6. 4. 3. 8  p_follower_stop_coord  CSU 

This  CSU  stops  the  follower  from  coordinating  with  the  leader  because  no  room  is  left  for 
intermediate  coordinating  points.  Instead  the  follower  is  headed  toward  the  route  goal 
point. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

'asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

Calls 

Function 

Where  Described 

vec2  init 

Sec.  2.14.3.S.20 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

vec2  COPY 

Sec.  2.14.3  5.29 

Table  2.6*228:  p_follower_stop_coord  CSU  [8.6.4.3.8] 

2. 6. 4. 3. 9  p_follower_gen_coord_goal_pnt  CSU 

This  CSU  generates  the  new  coordinate  goal  position.  It  also  decides  if  the  vehicle  is  about 
to  do  a  sharp  turn,  and  sets  the  coordinate  go^  point  to  zero  so  the  vehicle  will  fly  on  its 
own. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

'sabobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

'asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

'leader  asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

lead  est  pos 

VECTOR 

Sim  types.h 

point 

VECTOR 

Sim  types. h 

1  Calls  1 

Function 

Where  Described 

pilot  aet  speed 

Sec.  2.6.4.2.67 

p  follower  aet  wrid  offset 

Sec.  2.6.4.3  7 

vec2  sub 

Sec.  2.14.3.5.23 

OBJ  POSITION 

vec2  _maa2 

Sec.  2.14.3.5.27 

p  follower  stop  coord 

Sec.  2.6  4.3.8 

vec2  mag 

Sec.  2.14.3.5.26 

vec2  scale 

Sec.  2.14.3.5.28 

DEBUG  PILOT 

Sec.  2.5.2  2  See  Appendix  A 

Table  2.6-229:  p__follower_gen_coord_goal_pnt  CSU  [8.6.4.3.9] 
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2.6.4.3.10  p_follower_set_follow  CSU 

This  CSU  checks  a  vehicle  and  if  it  is  not  the  lead  vehicle  sets  it  to  follow. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•pilot 

pointer  to  PILOT  VARS 

Sec.  2.9.1 .2 

Table  2.6-230:  p_follower_set_follow  CSU  [8.6.4.3.10] 


2.6.4.3.11  p_follower_new_rel_rt_pnt  CSU 


This  CSU  generates  a  new  relative  route  point. 


I  Parameters  I 

Parameters 

Where  Typedef  Deciared 

•safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

pointer  to  AIR  SM 

Sec.  2.6  4.7 

•leader  asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

indep 

int 

Standard 

I  Calls  1 

Function 

Where  Described 

vec2  copy 

Sec.  2.14.3.5.29 

OBJ  POSITION 

p  follow  form  flip 

Sec.  2.6  4.3.2 

p  follower  find  pnt  in  turn 

Sec.  2.6.4.3.24 

vec2  init 

Sec.  2.14.3.5.20 

Table  2.6-231:  p_follower_new_rel_rt_pnt  CSU  [8.6.4.3.11] 


2.6.4.3.12  p_follower_flying_independent  CSU 
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Function 


follower  oassed 


OBJ  POSITION 


DEBUG  PILOT 


follower  new  rel  rt  ont 


vehicle  facino  Mint 


pjollower _gen_coord _goal_ 
nt 


vec2  sub 


vec2  maa2 


Hot  oet  speed 


Calls 


Where  Described 


Sec.  2.6.4.3.15 


Sec.  2.6.4.3.11 


Sec.  2.6.4.2.17 


Sec.  2.6.4.3.9 


Sec.  2.14.3.5.23 


Sec.  2.14.3.5.27 


Sec.  2.6.4.2.67 


endix  A 


endix  A 


Table  2.6-232:  p_follower_fiying_independent  CSU  [8.6.4.3.12] 


2.6.4.3.13  p_foIIower_foIlowroute_tick  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6  4.7 

‘leader  asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Value  in  leader  asm->sstate  is  none  of  the  expected  states. 

1  Calls  1 

Function 

Where  Described 

p  follower  hoverhold 

Sec.  2.6.4.3.18 

pilot  start  takinooff 

Sec.  2.6.4.2.24 

pilot  takinooff 

Sec.  2.6.4.2.25 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

pilot  on  same  route 

Sec.  2.6.4.2.15 

p  follower  new  rel  rt  pnt 

Sec.  2.6.4.3.11 

saf  vehicle  est  position 

Sec.  2.6.1.1.58 

p  follower  am  i  flying  coord 

Sec.  2.6.4.3.1 

p_follower_flying_ 

independent 

Sec.  2.6.4.3.12 

p  follower  passed  point 

Sec.  2.6.4.3.15 

OBJ  POSITION 

p  follower  stop  coord 

Sec.  2.6.4  3.8 

p  follower  set  desired  vel 

Sec.  2.6.4.3  6 

Table  2.6-233:  p_foIlower_followroute_tick  CSU  [8.4.3.13] 
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2.6.4.3.14  p_follower_ieader_passed_point  CSU 

This  CSU  uses  the  same  method  as  p_follower_passed_point,  which  follows,  for  the 
passing  of  point  detection  except  that  it  leaves  the  needed  variables  in  the  asm  p  set 
correcdy. 


Parameters 


I- 

E 

ns 


ast  loc 


cur  loc 


al 


Parameters 


inter  to  SAP  OBJECT 


inter  to  XYZ 


VECTOR 


VECTOR 


VECTOR 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Sim 


sim 


sim  t 


ReturnValues 


Return  Value 


FALSE 


TRUE 


Meanin 


Not  passed  point. 


Passed  point. 


Calls 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  maa2 

Sec.  2.14.3.5.27 

vec2  scale 

Sec.  2.14.3.5.28 

OBJ  DIRECTION 

Sec.  2.9.1. 1  See  Appendix  A 

Pilot  aet  speed 

Sec.  2.6.4.2.67 

vec2  dot 

Sec.  2.14.3.5.24 

Table  2.6-234:  p_foUowerJeader_passed__point  CSU  [8.6.4.3.14] 

2.6.4.3.15  p_follower_passed_point  CSU 
This  CSU  uses  the  dot  product  to  test  if  a  point  is  passed. 
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1  Calls  1 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  scale 

Sec.  2.14.3.5.28 

OBJ  DIRECTION 

Sec.  2.9.1. 1  See  Appendix  A 

Dilot  net  soeed 

Sec.  2.6.4.2.67 

vec2  dot 

Sec.  2.14.3.5.24 

Table  2.6>235:  p_follower_passed_point  CSU  [8.4.3.15] 


2.6.4.3.16  p_foIlower_hoverattack_tick  CSU 

This  CSU  does  nothing  presently,  and  is  included  because  it  is  called  elsewhere. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

‘leader  asm 

pointer  to  AIR  SM 

Sec.  2.6  4.7 

Table  2.6-236:  p_follower_hoverattack_tick  CSU  [8.6.4.3.16] 


2.6.4.3.17  p_follower_goto_pnt_coord  CSU 

This  CSU  causes  the  follower  to  coordinate  with  the  leader  on  the  immediate  goto  point 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

*leader asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

[Function 

Where  Described 

Sec.  2.6.1.1.58 

vec2  sub 

Sec.  2.14.3.5.23 

p  follower  fly  in  coord  pos 

Sec.  2.6  4.3.3 

pilot  qet  speed 

Sec.  2.6.4.2.67 

Table  2.6-237:  p_follower_goto_pnt_coord  CSU  [8.6.4.3.17] 
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2.6.4.3.18  p_follower_hoverhold  CSU 


This  CSU  looks  at  where  the  leader  is  stopping,  and  stops  the  follower  in  the  appropriate 
position,  taking  the  follower  out  of  the  "follow  leader"  mode. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

*leader  asm 

pointer  to  AIR  SM 

Sec.  2.6.4.7 

1  Calls  1 

Function 

Where  Described 

vec  copy 

Sec.  2.14.3.5.17 

OBJ  DIRECTION 

Sec.  2.9.1. 1  See  Appendix  A 

Sec.  2.6.1.1.58 

Ip  follower  fly  in  coord  pos 

Sec.  2.6.4.3.3 

Sec.  2.6.4.2.13 

combined  velocity 

Sec.  2.6.4.2.14 

p  follower  oet  wrid  offset 

Sec.  2  6.4.3.7 

vec  set 

Sec.  2.6.3.2.36 

pilot  init  hoverhold 

Sec.  2.6.4.2.30 

Table  2.6-238:  p_follower_hoverhold  CSU  [8.6.4.3.18] 


2.6.4.3.19  p_foIIower_Iand  CSU 


This  CSU  looks  where  the  leader  is  landing  and  lands  the  follower  in  the  appropriate 
position,  taking  the  follower  out  of  the  "follow  leader"  mode. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SYM 

Sec.  2.6.4.7 

‘leader  asm 

pointer  to  AIR  SYM 

Sec.  2.6  4.7 

1  Calls  1 

Function 

Where  Described 

p  follower  oet  wrid  offset 

Sec.  2.6.4.3.7 

OBJ  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

OBJ  DIRECTION 

Sec.  2.9. 1.1  See  Appendix  A 

DEBUG  PILOT 

pilot  init  land 

Sec.  2.6.4.2.39  1 

Table  2.6-239:  p_foIIowerJand  CSU  [8.6.4.3.19] 


308 


BBN  Systems  and  Technologies 


SAF  Simulation  Host  CSC 


2.6.4.3.20  p_follower_landhoId_tlck  CSU 
This  CSU  handles  following  the  leader  to  land. 


Parameters 


safobi 


Error  Name 


ERROR  ABORT 


Parameters 


inter  to  SAF  OBJECT 


inter  to  AIR  SYM 


inter  to  AIR  SYM 


Where  Tyoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.6.4.7 


Sec.  2.6.4.7 


Errors 


Reason  for  Error 


Value  in  leader  asm->sstate  is  none  of  the  ex 


ed  states. 


Function 


ilot  start  takinooff 


I  lot  takinooff 


DEBUG  PILOT 


vec2  sub 


OBJ  POSTION 


saf  vehicle  est  oosition 


follower  fiv  in  coord 


not  oet  speed 


|7 
f! 

r 


follower  land 


Calls 


Where  Described 


Sec.  2.6.4.2.24 


Sec.  2.6.4.2.25 


endix  A 


Sec.  2.14.3.5.23 


Sec.  2.9. 1.1  See  Appendix  A 


Sec.  2.6.1.1.58 


Sec.  2.6.4.3.3 


Sec.  2.6.4.2.67 


Sec.  2.6.4.2.13 


Sec.  2.6.4.2.14 


Sec.  2.6.4.3.19 


Table  2.6-240:  pjollowerjandholdjick  CSU  [8.6.4.3.20] 


2.6.4.3.21  p_follower_hoverhoId_tick  CSU 
This  CSU  handles  following  the  leader  to  a  hover. 
_ Parameters 


Parameters 

IType _ □ 

Where  Typedef  Declared 

*safobi 

JO 

inter  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•asm 

JO 

inter  to  AIR  SYM 

Sec.  2.6.4.7 

•leader  asm 

Op 

inter  to  AIR  SYM 

Sec.  2.6.4.7 

_ _ Errors _ 

Error  Name  Reason  for  Error 

ERROR  ABORT _  Value  in  leader  asm->sstate  is  none  of  the  expected  states. 
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Function 


ilot  start  takinooff 


lot  takinooff 


DEBUG  PILOT 


vec2  sub 


OBJ  POSITION 


saf  vehicle  est  oosition 


follower  fly  in  coord 


ra 


follower  hoverhold 


Calls 


Where  Described 


Sec.  2.6.4.2.24 


Sec.  2.6.4.2.25 


endix  A 


endix  A 


Sec.  2.6.1.1.58 


Sec.  2  6.4.3.3 


Sec.  2.6.4.2.67 


Sec.  2.6.4.2.13 


Sec.  2.6.4.2.14 


Sec.  2.6.4.3.18 


Table  2.6>241:  p_follower_hoverhold_tick  CSU  [8.6.4.3.21] 


2.6.4.3.22  piIot_foIlow_Ieader_tick  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SYM 

Sec.  2  6.4.7 

ReturnValues 

Return  Value 

Type 

Type 

FALSE 

int 

Value  in  leader_asm->pstate  is 
none  of  the  expected  states. 

Errors 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

Value  in  leader  asm->pstate  is  none  of  the  expected  states. 

Calls 

Function 

Where  Described 

pilot  qet  asm 

Sec.  2.6.4.2  84 

p  follower  hoverhold  tick 

Sec.  2.6.4.3.21 

pilot  orbit  tick 

Sec.  2.6.4.2.37 

p  follower  landhold  tick 

Sec.  2.6.4.3.20 

p  follower  followroute  tick 

Sec.  2.6.4.3.13 

p  follower  hoverattack  tick 

Sec.  2.6.4.3.16 

Table  2.6-242:  pilotjollowjeaderjick  CSU  [8.6.4.3.22] 
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2.6.4.3.23  p_foHower_flip_in_turn  CSU 

This  CSU  is  used  to  determine  for  the  leader  whether  the  turn  he  is  currently  executing  is  a 
hard  or  shallow  turn  and  whether  to  form  flip  (the  X  coordinates)  or  not. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

point  from 

VECTOR 

Sim  types.h 

point  at 

VECTOR 

Sim  types.h 

point  QOina  to 

VECTOR 

1  ReturnValues  1 

Return  Value 

Type 

Meanina 

1 

int 

No  formation  X  position  flip. 

-1 

int 

Flip  formation  X  positions. 

I  Calls  I 

Function 

Where  Described 

vec2  sub 

Sec.  2.14.3.5.23 

vec2  norm 

Sec.  2.14.3.5.31 

vec2  add 

Sec.  2.14.3.5.22 

abs 

Sec.  2. 6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 

vec2  copy 

Sec.  2.14.3.5.29 

vec2  mag2 

Sec.  2.14.3.5.27 

Table  2.6-243:  p_follower_fIip_in_turn  CSU  [8.6.4.3.23] 


2.6.4.3.24  p_follower_find_pnt_in_turn  CSU 

This  CSU  determines  if  a  turn  is  shallow  or  hard  and  gets  the  appropriate  point  for  which 
the  vehicle  is  to  head. 


_ _ Parameters _ _ 

Parameters  [Type  [Where  Typedef  Declared 

*safobi _ pointer  to  SAP  OBJ _ Sec.  2.9.1 .1 _ 

*asm _ pointer  to  AIR  SYM _ Sec.  2.6.4.7 _ 

*leader  asm _ pointer  to  AIR  SYM  Sec.  2.6.4. 7 _ 
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Function 


DEBUG  PILOT 


follower  hoverhold 


vec2  sub 


vec2  norm 


follower  ont  in  no  turn 


vec2  add 


abs 


vec2  maa2 


follower  ont  in  hard  turn 


p_follower_pntJn_shallow_ 

turn 


Calls 


Where  Described 


endix  A 


Sec.  2.6.4.3.18 


Sec.  2.14.3.5.23 


Sec.  2.14.3.5.31 


Sec.  2.6.4.3.25 


Sec.  2.14.3.5.22 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See 


Sec.  2.14.3.5.29 


Sec.  2.14.3.5.27 


Sec.  2.6.4.3.27 


Sec.  2.6.4.3.26 


ndix  A 


Table  2.6-244:  p_foUower_find_pnt_in_turn  CSU  [8.6.4.3.24] 
2.6.4.3.25  p_foIIower_pnt_in_no_turn  CSU 

This  CSU  gets  the  destination  for  a  vehicle  following  the  leader  to  the  last  point  on  the 
route. 


Parameters 


Parameters 


asm 


otnt 


incomminq  vec 


irs 


inter  to  AIR  SYM 


VECTOR 


VECTOR 


Where  Typedef  Declared 


Sec.  2.6.4.7 


Sim  t 


sim  types.h 


Calls 


Function  Where  Described 


follower  qet  wrid  offset  Sec.  2.6.4  3.7 


Table  2.6-245:  p_follower_pnMn_no_turn  CSU  [8.6.4.3.25] 


2.6.4.3.26  p_follower_pnMn_shallow_turn  CSU 

This  CSU  gets  the  destination  point  for  a  vehicle  following  the  leader  into  a  shallow  turn. 
This  is  done  by  rotating  the  formation  position  half  of  the  angle  of  the  final  turn. 
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1  Calls  1 

Function 

Where  Described 

vec2  copy 

Sec.  2.14.3.5.29 

vec2.  veh2world 

Sec.  2.6.3.2.37 

vec2  add 

Sec.  2.14.3.5.22 

DEBUG  PILOT 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6-246:  p_follower_pnt_in_shaIIow_turn  CSU  [8.6.4.3.26] 


2.6.4.3.27  p_follower_pnt_in_hard_turn  CSU 


This  CSU  gets  the  destination  point  for  a  vehicle  following  the  leader  into  a  sharp  turn.  It 
causes  the  information  to  end  up  mirror  imaged  altmg  the  y  axis  of  station  offsets  at  x=0 
after  the  turn.  The  information  rolls  under  itself  during  the  turn. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*asm 

pointer  to  AIR  SM 

Sec.  2.6  4.7 

*rt  pnt 

pointer  to  ROUTEPOINT 

Sec.  2.10.2.5 

perp 

VECTOR 

Sim  types.h 

last  rt  dir 

VECTOR 

Sim  types.h 

I  Calls  1 

Function 

Where  Described 

vec2  scale 

Sec.  2.14.3.5.28 

vec  dot  prod 

Sec.  2.6.2.54.1.1  Vehicles  CSCI  SDD 

vec2  add 

Sec.  2.14.3.5.22 

DEBUG  PILOT 

Table  2.6-247:  p_fonower_pnt_in_hard_turn  CSU  [8.6.3.27] 


2. 6. 4. 4  piane.c  CSC 

/simnet/src/host/^lane.c 


This  CSC  handles  everything  that  needs  to  be  done  by  a  fixed  wing  aircraft  each  tick.  This 
consists  of  a  single  CSU  plane_tick,  the  constant  definition  for  the  maximum  aircraft 
power, 


Constant 

Value 

MAX  AIRCRAFT  POWER 

2000000  /**  Newtons  **/ 

Table  2.6-248:  piane.c  Maximum  Aircraft  Power  Constant  Definition 
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the  values  in  three  three-element  arrays, 


Array 

Values 

REALA  INERTIA!  1 

{  10000.0.  1000.0.  10000.0  1 

REALA  Kin 

REAL  A  K2!  1 

(  18000.0.  20000.0.  700000.0  1  1 

Table  2.6*249:  plane.c  Array  Constants 


and  values  for  six  REAL  variables. 


Variable 

Value 

REAL  A  K4 

20.0 

REAL  A  K5 

.01 

REAL  A  K6 

50000  /*  REAL  A  K6  «  1 5000  */ 

REAL  A  K7 

22  r20*/  r  Airdraa  */ 

REAL  A  K8 

110  /*100V  r  Airdraa  V 

REAL  A  KP 

40000.0 

Table  2.6-250:  plane.c  Assigned  Variables 


Figure  2.6*16:  plane.c  CSC  Structure 
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Function 


DEBUG  AIR 


vec2  CO 


vec2  norm 


vec2  scale 


min 


vec  maos 


induce  roll 


induce  tail  spin 


RANGE  CLIP 


max 


square 


endix  A 


Calls 


Where  Described 


Sec.  2.14.3.5.29 


Sec.  2.14.3.5.31 


Sec.  2.14.3.5.28 


Sim  macros.h 


Sec.  2.6.4.6.11 


Sec.  2.6.4.6.10 


ndix  A 


Sec.  2.13.3.5  &  Sec.  2.6.7.3  See  A 


Sim  macros.h 


ndix  A 


ndix  A 


abs 


hu  llJojworldJ  ro  m_ 
orientation 


matrix  row  to  vector  Sec.  2.14.3.5.18 


Sec.  2  6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 


Sec.  2.6.4.6.8 


Table  2.6-251:  planejick  CSU  [8.6.4.4.1] 


2. 6. 4. 5  impact.c  CSC 
/simnet/src/hostAmpact.c 

This  file  handles  the  trajectory  and  impact  of  a  round  in  flight 


impact.c 

CSC 

8.6.4.5 


getJmpact_and_trajectory 
CSU  8.64.5. 1 


get_i_and_t_from_nornial 
CSU  8.6  4.5.2 


randomize_v®ctor 
CSU  8.6.4.5.3 


Figure  2.6-17:  impact.c  CSC  Structure 
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2 . 6 . 4 . 5 . 1  geMmpact_and_trajectory  CSU 


i 


Parameters 


**victim  hull  to  world 


victim  position 


victim  turret  azimuth 


victim  class 


sition 


component 


ct 


KiiS 


Parameters 


inter  to  pointer  to  REAL 


inter  to  REAL 


Anate 


VehicleClass 


I  pointer  to  REAL 


REAL 


I  pointer  to  VehicleComponent 


I  pointer  to  REAL 


inter  to  REAL 


Where  Typedef  Declared 


EGilffi 


Sim  t 


basic.h 


basic,  h 


Sim  t 


sim  t 


basic.h 


Sim  t 


sim  t 


Function 


vec  sub 


vec  normalize 


and  t  from  normal 


Calls 


Where  Described 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Sec.  2.2.6.4  5.2 


Table  2.6-252:  get_impact_and_trajectory  CSU  [8.6.4.5.1] 


2. 6. 4. 5. 2  get_i_and_t_from_normaI  CSU 


Parameters 


Parameters 


victim  hull  to  world 


victim  turret  azimuth 


victim  class 


‘normal  ray  to  victim 


component 


act 


trajecto 


lEITi 

irs 


inter  to  pointer  to  REAL 


Anale 


VehicleClass 


I  pointer  to  REAL 


REAL 


pointer  to  VehicleComponent 


pointer  to  REAL _ 


pointer  to  REAL 


Where  Tvpedef  Declared 


sim  tvpes.h 


basic.h 


basic.h 


basic.h 


sim_types.h 


simjypes.h 


Calls 

Function 

Where  Described 

check  prob 

Sec.  2.14.3.7.2 

mat  rot  init 

Sec.  2.6.2.47.1  Vehicles  CSCI  SDD 

simnet  anale  to  radians 


mat  mat  mul 


mat  CO 


vec  scale 


mat  vec  mul 


randomize  vector 


unsEi 


Sec.  2.6.2.32.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.31.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.35.1  Vehicles  CSCI  SDD 


Sec.  2.6.5.4  3 


Table  2.6-253:  get_i_and_t_from_normaI  CSU  [8.6.4.5.2] 
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2. 6. 4. 5. 3  randomize_vector  CSU 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

*v 

pointer  to  REAL 

Sim  tvpes.h 

distance 

REAL 

sim  types.h 

^result 

pointer  to  REAL 

simjypes.h 

Calls 

Function 

Where  Described 

get  me  a  random  fraction 

Sec.  2.14.3.7.1 

Table  2.6-254:  randoinize_vector  CSU  [8.6.4.5.3] 


2. 6. 4. 6  flyingveh.c  CSC 

/simnet/src/host/flyingveh.c 

This  file  contains  all  of  the  CSUs  specific  to  air  vehicles  where  the  standard  vehicle 
function  can  not  apply. 


flyingveh.c 

CSC 

8.6.4.6 


r  airveh  init 

V  CSU  8.6.4.6.1 

3C 

create  airveh 

CSU  8.64.6.2 

DC 

*  ■  ■  .. 
destroy  airveh 

CSU  8.6.4.6.3 

. I  "  ■ 

■  1" 

1 

r  airveh  show 

V  CSU  8.6.4.6.4 

airjtick 

CSU  8  6.4.6.5 

DC 

ainreh  mobility  kill 

CSU  8.6.4.6  6 

I _ 

I 

I 

1 

f  airveh  catastrophic  kill 
V  CSU  8.6.4.6.7 

hull_to_worldjrom_ 
orientation  CSU  8.6.4.6.8 

init  static  matricies 
CSU  8.6  4.6.9 

"  I  ■ 

1 

f  induce  tail  spin 

V.  CSU  876.4.6.10 

induce_roll 

CSU  8.6.4.6.11 

D 

Figure  2.6-18:  flyingveh.c  CSC  Structure 


It  also  includes  two  static  and  constant  definitions  prior  to  init_static_matricies  for  the  use 
of  the  remaining  CSUs. 


Constant 

tail  spin  matrix 

T  MATRIX 

roll  spin  matrix 

T  MATRIX 

Table  2.6-255:  flyingvehicle.c  Static  Defines 
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Constant 

Value 

ROLL  SPIN  ROTATION  RATE 

-0.05 

TAIL  SPIN  ROTATION  RATE 

0.05 

Table  2.6*256:  flyingvehicle.c  Constant  Definitions 


2. 6. 4. 6.1  airveh  ink  CSU 


This  CSU  initializes  the  members  of  an  airveh  data  structure. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘airveh 

pointer  to  AiRVEH  VARS 

Sec.  2.9.1 .2 

‘table 

pointer  to  DATA  UNiON 

Sec.  2.1. 1.5 

1  Calls  1 

Function 

Where  Described 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

ft  float 

Sec.  2.14.1.2.12 

dea  to  rad 

Sim  macros.h 

kph  to  mps 

III'— —1— 

Table  2.6*257:  airveh  init  CSU  [8.6.4.6.11 


2. 6. 4. 6. 2  create  airveh  CSU 


This  CSU  allocates  space  for  an  airveh  data  structure  and  calls  airveh_init  to  initialize  its 
members. 


i  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘table 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

I  ReturnValues  1 

Return  Value 

Type 

Meaning 

airveh 

pointer  to  AIRVEH  VARS 

Data  structure  created. 

1  Calls  1 

Function 

Where  Described  1 

allocate  airveh 

airveh  init 

Sec.  2.6  4.6. 1  1 

Table  2.6*258:  create_airveh  CSU  [8.6.4.6.2] 
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2. 6. 4. 6. 3  destroy_airveh  CSU 


This  CSU  deallocates  memory  space  previously  allocated  fw  an  airveh  data  structure,  by 
c^ing  the  function  deallocate.airveh. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Calls 

Function 

Where  Described 

deallocate  airveh 

Sec.  2.9.1. 2 

Table  2.6-259:  destroy^airveh  CSU  [8.6.4.6.3] 


2. 6. 4. 6. 4  airveh  show  CSU 


This  CSU  displays  the  air  vehicle  variables  associated  with  flight. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

print  vector 

Sec.  2.14.3.5.2 

Table  2.6-260:  airveh  show  CSU  [8.6.4.6.4] 


2. 6. 4. 6. 5  air  tick  CSU 


1  Parameters  1 

1  Parameters 

Type 

Where  Tvpedef  Declared 

1  *safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

Errors 

Error  Name 

Reason  for  Error 

ERROR_ABORT 

The  air  vehicle  has  crashed  and  it  is  neither  a  helicopter  nor  a 
plane;  or  the  value  in  airveh->crashing_state  is  none  of  the 
expected  states. 

Calls 

Function 

Where  Described 

helo  tick 

Sec.  2.6.4.1.1 

plane  tick 

Sec.  2.6.4.4.1 

around  level 

Sec.  2.6.4.2.8 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

sat  vehicle  catastrophic  _kill 

Sec.  2.6.1.1.25 

Table  2.6-261:  air  tick  CSU  [8.6.4.6.5] 
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2. 6. 4. 6. 6  airveh_mobility_kill  CSU 

This  CSU  sets  the  air  vehicle  crashing  state  to  'crashing'. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

Errors 

Error  Nfeme 

Reason  for  Error 

ERROR  ABORT 

There  is  no  air  vehicle. 

Table  2.6-262:  airveh_inobility_kni  CSU  [8.6.4.6.6] 


2. 6. 4. 6. 7  airveh_catastrophic_kiil  CSU 

This  CSU  sets  the  air  vehicle  crashing  state  to  'crashing'. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

1  Errors  1 

Error  Name 

Reason  for  Error 

ERROR  ABORT 

There  is  no  air  vehicle. 

Table  2.6-263:  airveh_catastrophic_kill  CSU  [8.6.4.6.7] 


2. 6. 4. 6. 8  hull  to  world  from  orientation  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

orientation 

VECTOR 

Sim  types. h 

h2w 

T  MATRIX 

Sim  types. h 

Table  2.6-264:  hull_to_world_from_orientatlon  CSU  [8.6.4.6.8] 


2. 6. 4. 6. 9  init_static_matricies  CSU 

This  CSU  initializes  spin  and  roll  matrices. 


1  Calls  1 

Function 

Where  Described 

mat  rot  init 

Sec.  2. 

Table  2.6-265:  init_static_matricies  CSU  [8.6.4.6.9] 
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2.6.4.6.10  induce_tail_ 

spin  CSU 

1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

h2w 

T  MATRIX 

Sim  types.h 

Calls 

Function 

Where  Described 

mat  mat  mul 

Sec.  2.6.2.32.1  Vehicles  CSCI  SDD 

Table  2.6-266:  induce_tail_spin  CSU  [8.6.4.6.10] 


2.6.4.6.11  induce  roll  CSV 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

h2w 

T  MATRIX 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

mat  mat  mul 

Sec.  2.6.2.32.1  Vehicles  CSCI  SDD 

Table  1.6-161:  induce  roll  CSU  [8.6.4.6.11] 


2. 6. 4. 7  flyingveh.h  CSU 

/simnet/src/host/flyingveh.h 

This  CSU  contains  all  of  the  definitions,  macros,  and  symbolic  constants  needed  by  the 
flying  vehicle  code.  The  constants  and  structure  definitions  are  contained  in  the  following 
tables.  The  macros  POSITION,  VEHICLEID,  DT,  ERROR_ABORT,  and 
INSIDE_BOX2  (point,  tolerance)  are  described  in  Appendix  A. 


Constant 

Value 

CIRCLE  LOOKAHEAD  TIME 

1.5 

DONT  RELAND  DISTANCE 

100.0 

TOL2 

2500.0 

DECELLERATION  Z 

DECEL 

1.5 

MIN  TURN  SPEED 

1.0 

MAX  BACKUP  SPEED 

1.0 

MAX  BACKUP  DIST2 

1.0 

Table  2.6-268:  flyingveh.h  Movement  Constant  Definitions 


Constant 

Value 

HELO 

0 

PLANE 

1 

Table  2.6-269:  flyingveh.h  Vehicle  Types  Constant  Definitions 
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Constant _ Value _ 

CRASHING  STATE  ALIVE _  0 _ 

CRASHING  STAfE  CRASHING _ J _ 

CRASHING  STATE  CRASHED _  2 _ 

CRASHING  STATE  LANDING _  3 _ 

crashing" STATE~TAKING0FF  4 

Table  2.6>270:  flyingveh.h  Flying  Vehicle  Crash  State  Deflnitions 


Constant 

lvalue  1 

PSTATE  IDLE 

PSTATE  HOVERHOLD 

|3  1 

PSTATE  ORBITHOLD 

PSTATE  RACETRACKHOLD 

5 

PSTATE  LANDHOLD 

6 

PSTATE  FOLLOWROUTE 

PSTATE  FOLLOWVEHICLE 

10 

PSTATE  FOLLOWLEADER 

11 

PSTATE  HOVERATTACK 

12 

PSTATE  RUNNINGATTACK 

13 

PSTATE  FACEDIRECTION 

14 

SSTATE  LANDED 

20 

SSTATE  TAKINGOFF 

21 

SSTATE  LANDING 

22 

SSTATE  GOTOPOINT 

23 

SSTATE  COMPLETE 

24 

SSTATE  APPROACH 

25 

SSTATE  HOVERATTACK 

26 

SSTATE  EGRESS 

27 

SSTATE  FOLLOWLEAD 

28 

SSTATE  FOLLOW  HOVER 

29 

Table  2.6-271:  flyingveh.h  Plane  and  Helicopter  State  Constant 

Deflnitions 


Constant 

Value  1 

FIRE  STATE  OFF 

FIRE  STATE  FIRE 

1 

FIRE  STATE  RUN 

2 

Table  2.6-272:  flyingveh.h  Fire  At  Will  States  Constant  Deflnitions 
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Constant  I  Value 


CONTOUR  I  1 


LOWLEVEL  12 


METERSAGL  1 3 


JINK 


TACTICALCOLUMN  I S 


BOUNDING  16 


BOUNDINGOVERWATCH 


REATTACK  1 9 


RUNNINGFIRE  110 


HOVERFIRE  TTT 


Table  2.6>273:  flyingveh.h  Modifiers  Constant  Definitions 


Constant 

Value 

DIR  POINT  ERROR 

.04 

FWA  TURN  DIP  ERR 

.09 

MAX  TURN  CIRCUMF 

24000 

INTERMEDIATE  POINT  TYPE 

10 

NO  TURN 

0 

SHALLOW  TURN 

1 

HARD  TURN 

-1 

SHALLOW  HARD  TURN  VEC  MAG 

3.879383241 

ST  KP  DIST  HELO 

INTERMEDIATE  POINT  TYPE/2 

ST  KP  DIST  PLANE 

INTERMEDIATE  POINT  TYPE 

Table  2.6*274:  flyingveh.h  Station  Keeping  Constant  Definitions 


Constant 

Value 

M 

0 

MIS 

1 

Table  2.6-275:  flyingveh.h  State  Machines  Constant  Definitions 
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The  following  structure  is  tagged  xyz. 


Item 

Where  Tyne  Defined 

DOS  cur 

VECTOR 

Sim  tvDes.h 

DOS  ref 

VECTOR 

Sim  tvDes.h 

DOS  err 

VECTOR 

Sim  tvDes.h 

dir  ref 

VECTOR 

Sim  tvDes.h 

vel  des 

VECTOR 

Sim  tvDes.h 

REAL 

Sim  tvDes.h 

ranae2 

REAL 

Sim  tvDes.h 

REAL 

Sim  tvDes.h 

XV  ranae2 

REAL 

Sim  tvDes.h 

XV  sDeed  des 

REAL 

SDeed  des 

REAL 

Sim  tvDes.h  I 

anale.err 

REAL 

eDSilon2 

REAL 

Sim  tvDes.h  I 

Table  2.6-276: 


XYZ  Structure  Definition 
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The  following  structure  is  tagged  asm. 


Table  2.6-277:  AIR  SM  Structure  Definition 
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2.6.5  Intervisibility  CSC 

The  Intervisibility  CSC  [8.6.5]  consists  of  the  detection.c  CSC  [8.6.5. 1]  and  the  intervis.c 
CSC  [8.6.5.2].  The  structure  of  CSC  8.6.5  is  found  in  the  following  figure. 

Intervisibility 

CSC 


detection.c 

CSC 

8.6.5. 1 


intervis.c 

CSC 

8.6.5.2 

Figure  2.6-19:  Intervisibilty  CSC  Structure 


2.6.5. 1  detection.c  CSC 

/simnet/src/host/detection.c 

This  file  handles  the  tracking  of  other  vehicles,  maintaining  and  updating  the  list  of  the 
other  vehicles  that  this  one  currently  knows  about  (that  it  has  seen  and  still  can  see).  This 
information  is  used  to  determine  which  vehicles  will  be  drawn  on  the  workstation  screen, 
and  also  in  maintaining  this  vehicle's  target  list. 


detection.c 

CSC 

8.6.5.1 


major_detection_increase 
CSU  8.6.5.1.13 


Figure  2.6-20:  detection.c  CSC  Structure 
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2. 6. 5. 1.1  create  detection  CSU 


This  CSU  creates  a  detection  variable  by  allocating  memory  space  for  it. 


1  ReturnValues  1 

Return  Value 

Type 

Meaning 

s 

pointer  to  DETECTION  VARS 

Sec.  2.9. 1.2 

1  Calls  1 

Function 

Where  Described  1 

allocate  detection 

clear  detection 

Sec.  2.6.5.1.2  I 

Table  2.6-277:  create  detection  CSU  [8.6.5.1.1] 


2. 6. 5. 1.2  clear  detection  CSU 


This  CSU  initializes  the  members  of  a  detection  data  structure  to  zero. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•detection 

pointer  to  DETECTION  VARS 

Sec.  2.9.1. 2 

Table  2.6-278:  clear^detection  CSU  [8.6.5.1.21 


2.6.5. 1.3  destroy_detection  CSU 


This  CSU  deallocates  a  detection  data  structure  by  calling  deallocate_detection. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*d 

pointer  to  DETECTION  VARS 

Sec.  2.9.1. 2 

Calls 

Function 

Where  Described 

deallocate  detection 

Sec.  2.9.1. 2  See  Appendix  A 

Table  2.6-279:  destroy_detection  CSU  [8.6.5.1.3] 


2.6.5. 1.4  detection  remove  vehicles  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*d 

pointer  to  DETECTION  VARS 

Sec.  2.9.1. 2 

num 

int 

Standard 

V  list 

unsigned  int 

Standard 

Table  2.6-280:  detection_remove_vehicles  CSU  [8.6.5. 1.4] 
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2. 6. 5. 1.5  detection_show  CSU 

This  CSU  displays  a  listing  of  the  vehicles  arranged  by  detection  type. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

detection  show  type 

Sec.  2.6.5.1.6 

Table  2.6>281:  detection  show  CSU  [8.6.5.1.5] 


2. 6. 5. 1.6  detection_show_type  CSU 


This  CSU  displays  all  the  vehicles  having  the  given  detection  type. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

tabn _ 

unsianed  char 

Standard 

int 

Standard 

I  Calls  I 

Function 

Where  Described 

LOOKUP  VEHICLE 

Sec.  2.9.3.2  See  Appendix  A 

Table  2.6-282:  detection_show_type  CSU  [8.6.5.1.61 


2. 6. 5. 1.7  compute_enemy_weight  CSU 


This  CSU  ranks  enemy  vehicles  according  to  my  type  and  their  type. 


I  Parameters  I 

Parameters 

Where  Typedef  Declared 

*me 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*him 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

I  ReturnVaiues  I 

Return  Value 

Type 

Meaning 

1 

int 

No  targeting  action. 

16 

int 

1  am  targeting  an  enemy 
aircraft. 

1  Calls  1 

Function 

Where  Described 

IS  AIRCRAFT 

OBJECT  TYPE 

Table  2.6-283:  compute_enemy_weight  CSU  [8.6.5.1.7] 
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Parameters 


*safobi 


vec 


Parameters 


I  pointer  to  SAP  OBJECT 


REAL 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sim  t 


Function 


turret  interest  dir 


vec  CO 


OBJ  DIRECTION 


Calls 


Where  Described 


Sec.  2.6  9.6.9 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


endix  A 


Table  2.6>284:  compute_interest_direction  CSU  [8.6.5.1.8] 


2. 6. 5. 1.9  arc  of  attention  CSU 


Parameters 


anole  to  taroet 


lEin 


e 


REAL 


Parameters 


Where  Tvoedef  Declared 


sim  types. h 


Return  Value 


PRIMARY  ARC 


SECONDARY  ARC 


ReturnValues 


Meanin 


Anole  to  taroet  <=  Pi/3 


Anole  to  taroet  >  Pi/3 


Function 


abs 


Calls 


Where  Described 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 


Table  2.6-285:  arc  of  attention  CSU  [8.6.5.1.9] 


2.6.5.1.10  detectable  CSU 

This  CSU  returns  0  if  undetectable  or  else  a  number  between  1  and  99  that  encodes  the 
random  number  that  was  rolled  to  determine  a  positive  detection. 
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ReturnValues 


Return  Value 


max(1,locaLrand) 


Meanin 


Positive  detection  random 
number. 


Undetectable. 


Function 


vec  dot  orod 


abs 


intenor_angle_between_ 

vectors 


database  detection  aue 


et  me  a  random  fraction 


Calls 


Where  Described 


Sec.  2.6.2.6541  Vehicles  CSCI  SDD 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  ADoendix  A 


Sec.  2.14.3.5.8 


Sec.  2  6.8.2.2 


Sec.  2.14.3.7.1 


Sec.  2.6.7.3  &  Sec.  2.13.3.5  See  AoDendix  A 


Table  2.6>286:  detectable  CSU  [8.6.5.1.10] 


2.6.5.1.11  detection  tick  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described  I 

OBJ  POSITION 

OBJ  FORCEID 

Sec.  2.9.1. 1  See  Appendix  A 

compute  interest  direction 

Sec.  2.6.5.1.8 

FOR  VEHICLES  WITHIN  N 
GRIDS  DO 

Sec.  2.9.3.2  See  Appendix  A 

OBJ  VEHICLEID 

Sec.  2.9.1. 1  See  Appendix  A 

intervis  possibly  visible 

Sec.  2.6.5.2.3 

compute  enemy  weight 

Sec.  2.6.5.1.7 

detectable 

Sec.  2.6.5.1.10 

OBJ  VELOCITY 

Sec.  2.9.1. 1  See  Appendix  A 

Table  2.6-287:  detection  tick  CSU  [8.6.5.1.11] 


2.6.5.1.12  detection_save_weight  CSU 


Table  2.6-288:  detection_save_weight  CSU  [8.6.5.1.12] 


330 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


2.6.5.1.13  major_detection_increase  CSU 

An  increase  of  40%  in  detection  weight  is  a  major  detection  increase. 

Prior  to  this  CSU,  40%  value  for  the  detection  increase  threshold  is  defuied  as  a  constant 
(#define  DETECTION  JNCREASE.THRESHOLD  40). 


i  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

ReturnValues 

Return  Value 

Type 

Meanina 

FALSE 

int 

No  chance  in  enemy  weiqht. 

TRUE 

int 

Enemy  weight  increased  from 

0  or  jumped  from  one  level  to  a 
higher  level  beyond  the 
detection  increase  threshold. 

Calls 

Function 

Where  Described 

DEBUG  TARGETING 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6*289:  major_detection_increase  CSU  [8.6.5.1.13] 


2. 6. 5. 2  intervis.c  CSC 
/simnet/src/host^ntervis.c 

This  CSC  contains  the  code  which  handles  all  the  cases  involving  what  other  vehicles  the 
current  vehicle  can  see.  Please  note  that  this  does  not  guarantee  that  another  vehicle  which 
can  be  seen  will  be  seen.  That  is  handled  by  the  detection  code. 


Figure  2.6-21:  intervis.c  CSC  Structure 
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2. 6. 5. 2.1  intervis_can_see_pt_to_pt  CSU 

This  CSU  checks  the  visibility  from  my  point  to  his  point  and  returns  FALSE  if  it  is 
completely  blocked,  TRUE  if  partially  blocked  or  open. 


Parameters 


s 


s 


iriTT-W»T» 


Parameters 


I  DOinter  to  REAL 


pointer  to  REAL 


Where  Typedef  Declared 


sim 


Sim  t 


RetumValues 


Return  Value 


TRUE 


FALSE 


Meanin 


Visibility  is  full  or  only  partially 
blocked. 


Visibility  is  completely 
blocked. 


Function 


intervis  pt  to  pt 


Calls 


Where  Described 


Sec.  2.5.5.2  4 


Table  2.6-290:  intervis_can_see_pt_to_pt  CSU  [8.6.5.2.1] 


2. 6. 5. 2. 2  intervis_get_view  CSU 


1  Parameters 

Parameters 

Type 

Where  Typedef  Declared 

*mv  pos 

pointer  to  REAL 

Sim  types.h 

*his  pos 

pointer  to  REAL 

Sim  types.h 

*his vel 

pointer  to  REAL 

sim types.h 

RetumValues 

Return  Value 

Type 

Meaning 

HULL_DOWN 

int 

Visibility  is  partially  blocked  by 
solid  or  by  solid  and  trees. 

STATIONARY 

int 

Visibility  is  full  or  partially 
blocked  by  trees,  and  he  is 
movina  at  a  small  velocity. 

MOVING 

int 

Neither  of  the  above  two 
conditions  holds. 

VIEW_BLOCKED 

int 

Visibility  is  completely 
blocked. 

Calls 

Function 

Where  Described 

intervis  pt  to  pt 

Sec.  2.6.5.2.4 

vec  dot  prod 

Sec.  2.6.2.54.1  Vehicles  CSCI  SDD 

Table  2.6-291:  intervls_get_view  CSU  [8.6.5.2.2] 
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2. 6. 5. 2. 3  intervis_possibly_visible  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•from 

pointer  to  REAL 

Sim  tvpes.h 

•to 

pointer  to  REAL 

Sim  types.h 

ReturnVaiues 

Return  Value 

Type 

Meaning 

INVISIBLE 

int 

The  from  or  to  coordinates  are 
not  in  the  database. 

FALSE 

int 

Visibility  parameter  reads 
invisible,  or  unexpected 
results  occur. 

TRUE 

int 

Visibility  parameter  reads 
dummy  or  fully-visible. 

Calls 

Function 

Where  Described 

coords  within  database 

Sec.  2.13.3.1  See  Appendix  A 

set  pv  params 

Sec.  2.6.5.2.6 

pve  checkvis 

Sec.  2.6.7.1.1 

Table  2.6*292:  intervis_possibly_visible  CSU  18.6.5.2.3] 


2. 6. 5. 2. 4  intervis_pt_to_pt  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•from 

pointer  to  REAL 

Sim  types.h 

•to 

pointer  to  REAL 

Sim  types.h 

1  ReturnVaiues  1 

Return  Value 

Meaning 

INVISIBLE 

int 

The  from  or  to  coordinates  are 
not  in  the  database. 

pve  checkvis(...) 

int 

Visibility  parameter. 

1  Calls  1 

Function 

Where  Described 

coords  within  database 

Sec.  2.13.3.1  See  Appendix  A 

set  pv  params 

Sec.  2.6.5  2.6 

pve  checkvis 

Sec.  2.6.7.1.1 

Table  2.6-293:  intervis_pt_to_pt  CSU  [8.6.5.2.4] 
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2. 6. 5. 2. 5  intervis_get_high_ground  CSU 


Parameters 


from 


to 


umim 


Return  Value 


FALSE 


TRUE 


Function 


coords  within  database 


set  Dv  oarams 


ve  checkvis 


Parameters 


inter  to  REAL 


inter  to  REAL 


inter  to  REAL 


ReturnValues 


Calls 


Where  Described 


Sec.  2.13.3.1  See  A 


Sec.  2.6.5.2.6 


Sec.  2.6.7.1.1 


Where  Tyoedef  Declared 


Sim  t 


sim  t 


Meanin 


The  from  or  to  coordinates  are 
not  in  the  database. 


Success. 


32? 


ndix  A 


Table  2.6-294:  intervis_get_high_ground  CSU  [8.6.5.2.5] 


2. 6. 5. 2. 6  set_pv_params  CSU 


Prior  to  this  CSU,  the  constants  S_EYE_HEIGHT  and  S_FC)OT_HEIGHT  are  defined  as 
2.0  and  0.5  respectively. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*vis  ptr 

pointer  to  PV  PARAMS 

Sec.  2.6.7.4 

from 

VECTOR 

sim  types.h 

to 

VECTOR 

Sim  types.h 

test 

int 

Standard 

Table  2.6-295:  set_pv_params  CSU  [8.6.5.2.6] 


2.6.6  Resupply  CSC 

The  Resupply  CSC  [8.6.6]  consists  of  the  logistics.c  CSC  [8.6.6.1]  and  the  logistics.h 
CSC  [8.6.6.2].  The  sJiicture  of  CSC  8.6.6  is  found  in  the  following  figure. 
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logistics  tick 


CSU  8.6.6.1.10 


Figure  2.6-22:  Logistics  CSC  Structure 


2.6.6. 1  logistics.c  CSC 
/simnet/src/host/logistics.c 

This  code  handles  the  resupply  of  SAF  vehicles  from  resupply  vehicles  on  the  database. 


2. 6. 6. 1.1  createjogistics  CSU 

This  CSU  allocates  memory  space  for  and  initializes  the  members  of  a  logistics  data 
structure. 


1  ReturnVaiues  1 

Return  Value 

Meaning 

log 

int 

Created  logistics  data 
structure. 

1  Calls  1 

Function 

Where  Described 

allocate  looistics 

Sec.  2.9.1. 2  See  Appendix  A 

Table  2.6-296:  createjogistics  CSU  [8.6.6.1.1] 
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2. 6. 6. 1.2  destroy_logistics  CSU 

This  CSU  deallocates  memoiy  space  that  was  previously  reserved  for  a  logistics  data 
structure. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*ioa 

pointer  to  LOGISTICS. VARS 

Sec.  2.9.1 .2 

1  Calls  1 

Function 

Where  Described 

buffer  deallocate 

Sec.  2.14.4.2.15 

deallocate  loqistics 

Table  2.6-297:  destroy_logistics  CSU  [8.6.6.1.2] 


2. 6. 6. 1.3  logistics_remove_vehicles  CSU 

If  a  supply  vehicle  is  on  a  list  provided  to  this  CSU,  it  is  removed  from  a  logistics  data 
structure. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*IOQ 

pointer  to  LOGISTICS  VARS 

Sec.  2.9.1. 2 

num 

int 

Standard 

V  listfl 

unsiqned  int 

Standard 

Table  2.6-298:  logistics_remove_vehicles  CSU  [8.6.6.1.3] 


2.6.6. 1.4  start_resupply_of_to  CSU 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

supplier  id 

unsigned  int 

Standard 

Calls 

Function 

Where  Described 

DEBUG  VEHICLE 

Sec.  2.5.2. 2  See  Appendix  A 

Table  2.6-299:  start_resupply_of_to  CSU  [8.6.6.1.4] 
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2. 6. 6. 1.5  resupIy_check_ok  CSU 


This  CSU  returns  TRUE  if  conditions  to  resupply  are  met. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

‘supplier 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  ReturnVaiues  1 

Return  Value 

Type 

Meanina 

TRUE 

int 

Conditions  are  met. 

FALSE 

int 

Conditions  are  not  met. 

1  Calls  1 

Function 

Where  Described 

sbx  print! 

Sec.  2.4.3.2.8 

OBJ  VEHICLEID 

Sec.  2.9. 1.1  See  Appendix  A 

OBJ  OWNER  PORT 
NUMBER 

Sec.  2.9.1. 1  See  Appendix  A 

is  dead 

Sec.  2.13.3.1  See  Appendix  A 

OBJ  APPEARANCE 

Sec.  2.9.1. 1  See  Appendix  A 

OBJ  VEHICLECLASS 

VEC  SMALLER3 

Sec.  2.14.3.9  See  Appendix  A 

OBJ  VELOCITY 

Sec.  2.9.1. 1  See  Appendix  A 

VEC  SMALLER2 

Sec.  2.14.3.9  See  Appendix  A 

Table  2.6-300:  resuply_clieck_ok  CSV  [8.6,6.1.S] 


2.6.6. 1.6  resuppIy_bid_ammo_needs  CSV 


!  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

‘array  size 

pointer  to  unsigned  char 

Standard 

basic,  h 

Table  2.6-301:  resupply_bld_ammo_needs  CSU  [8.6.6.1.6] 
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2. 6. 6. 1.7  choose_resupply_iteni  CSU 

This  CSU  builds  a  list  of  needs  and  compares  it  to  a  list  of  items  offered,  finds  ai^ 
intersection. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*safobi 

pointer  to  SAF  OBJcCT 

Sec.  2.9.1. 1 

‘needs  size 

pointer  to  unsiqned  char 

Standard 

needs  arfi 

basic,  h 

basic.h 

1  ‘munition 

pointer  to  OblectTvpe 

p  sim.h 

pointer  to  float 

Standard 

1  Calls  1 

Function 

Where  Described 

resupply  bid  ammo  needs 

Sec.  2.6.6.1.6 

Table  2.6-302:  choose_resupply_item  CSU  [8.6.6.1.7] 


2.6.6. 1.8  logistics_supply_offer_caiiceIed  CSU 
This  CSU  handles  the  cancel  packet  when  it  comes  in. 


1  Parameters  1 

1  Parameters 

Where  Tvpedef  Declared 

pointer  to  LOGICTICS  VARS 

Sec.  2.9.1. 2 

Table  2.6-303;  logistics_supply_offer_canceIed  CSU  [8.6.6.1.8] 


2. 6. 6. 1.9  logistics_supply_offer_received  CSU 

This  CSU  handles  the  packet  when  it  comes  in.  Array  use  is  as  follows: 


array [0] .quantity  :  number  of  array  items,  including  this  one 
arraylO]  .munition  :  not  used 

array [1+].*  :  munition  entries 


1  Parameters  1 

1  Parameters 

Where  Tvpedef  Declared 

pointer  to  LOGICTICS  VARS 

Sec.  2.5. 1.2 

l‘spdu 

pointer  to  SimulationPDU 

p  sim.h 

1  Calls  1 

Function 

Where  Described 

saf  id  from  simnet  id 

DEBUG  VEHICLE 

Sec.  2.5  2.2  See  Appendix  A 

heap  allocate 

Sec.  2.14.2.1.1 

Table  2.6-304:  logistics_supply_offer_received  CSU  [8.6.6. 1.9] 
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2.6.6.1.10  logistics_tick  CSU 


This  CSU  handles  vehicle  resupply. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1 .1 

1  Calls  1 

Function 

Where  Described  1 

IS  RESUPPLYING 

1  II  [j—— — — 

LOOKUP  SAFOBJ 

1  Mill  mm  Ml  1  inii—— — ■ 

resuDiv  check  ok 

Sec.  2.6.6.1.5 

range  squared 

Sec.  2.14.3.5.10 

OBJ  POSITION 

DEBUG  VEHICLE 

Sec.  2.5.2.2  See  Appendix  A 

OBJ  VEHICLEID 

Sec.  2.9. 1.1  See  Appendix  A 

sbx  printl 

Sec.  2.4.3.2.8 

OBJ  OWNER  PORT 
NUMBER 

Sec.  2.9.1. 1  See  Appendix  A 

choose  resupply  item 

Sec.  2.6.6.1.7 

min 

Sec.  2. 6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

resupply  bid  ammo  needs 

Sec.  2.6.6.1.6 

simnet_send_resupply_ 

request 

simnet_send_resupply_ 

received 

simnet_send_resupply_ 

cancel 

Table  2.6-305:  logisticsjick  CSU  [8.6.6.1.10] 
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2. 6. 6. 2  logistics.h  CSU 

/simnet/src^ost/logistics.h 

This  CSU  contains  the  symbolic  constants  used  by  the  resupply  code,  as  shown  in  the 
following  table,  and  a  single  macro,  IS_RESUPPLYING(a),  defined  in  Appendix  A. 


Constant 

Value 

LCX3ISTICS  STATE  READY 

0 

LCX3ISTICS  STATE  REQUESTING 

1 

LOGISTICS  STATE  RECEIVING 

2 

RESUPPLY  MIN  DISTANCE 

1000.0 

MILLISEC 

1000 

RESUPPLY  STD  TIME  OUT 

40.0  r  sec  */ 

RESUPPLY  UNIT  AMMO 

1.0  r  rounds  oer  RESUPPLY  TIME  UNIT  */ 

RESUPPLY  UNIT  FUEL 

20.0  r  aallons  oer  RESUPPLY  TIME  UNIT  */ 

RESUPPLY  UNIT  FUEL  SEC 

1600.0  r  seconds  of  fuel  per  "  */ 

RESUPPLY  FUEL  SEC  PER  SEC 

40 

RESUPPLY  FUEL  GAL  PER  SEC 

.5 

RESUPPLY  FUEL  GAL  TO  SEC 

80 

Table  2.6-306:  logistics.h  Constant  Definitions 


2.6.7  libpvis  CSC 
/simnet/libsrc/libpvis 

This  library  deals  with  issues  concerning  the  intervisibility;  the  total,  partial,  or  lack  of 
visibility  of  objects  by  the  eyes  of  the  observor. 


Figure  2.6-23:  pve_checkvis.c  CSC  Structure 

There  are  a  number  of  factors  (condidonal  definiticxis)  that  determine  what  (and  how)  this 
library  does  in  terms  of  type  of  calculations,  database  format,  debugging,  etc.  The  setting 
of  constant  defines  is  done  in  both  pve_checkvis.c  ( see  Sec.  2.6.7. 1)  and  pvis_call.h  (  see 
Sec.  2.6.7 .4).  A  define  of  0  means  that  the  code  segment  indicated  is  undefined  and  not  to 
be  compiled  and  executed,  while  a  value  of  1  causes  the  code  to  be  included  in  the  compile. 
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2. 6. 7.1  pve_checkvis.c  CSC 
/siinnel/libsrc/libpvis/pve_checkvis.c 

This  CSC  contains  CSUs  which  determine  the  degree  of  visibility  of  objects. 


pve_checkvis.c 

CSC 

8.6.7.1 


r  pve  checkvis 

V  CSU8.6.7.1.1 

DC 

_ 1 

startup 

CSU  8.6.7.1.2 

DC 

- ^ - s. 

dip  to  tdb  A 

CSU8.6.7.1.3  J 

'■  . r 

1 

1 

r  test  mins 

V  CSU8.6.7.1.4 

DC 

test  maxima 

CSU  8.6.7. 1.5 

DC 

patch 

CSU  8.6.7. 1.6  J 

. .  1  " 

1 

- 1 

r  terrain 

V  CSU8.6.7.1.7 

DC 

check  edges 

CSU  8.6  7.1. 8 

DC 

get  mid__pt  'N 

CSU  8.6.71. 9  J 

1 

1  ■■ 

n 

r  compute  mid 

V  CSU  8.6.7.1.10 

JC 

check  edge  hit 
CSU  8.6.7.1.11 

DC 

objects 

CSU  8.6.7.1.12  J 

_ 1 _ 

1  ■ 

1 

1 

1 

check  object 

CSU  8.6.7.1.14 

JC 

trees  A 

CSU  8.6.7.1.15  J 

1  :  — 

■■  I . 

-  1 

JC 

report  tree  blod( 
CSU  8.6.7.1.17 

JC 

canopies  ^ 

CSU  8.6.7.1.18  J 

1 

1 

\ 

^  store_hit 

V  CSU  8.6.7.1.19 

JC 

average 

CSU  8.6.7.1.20 

JC 

check  hits  ’N 

CSU  8.6.7.1.21  J 

"  ”  1" 

1 

1 

f  report  hit 

V  CSU  8.6.7.1.22 

JC 

prirrt  ch_pt  info 
CSU  8.6.7.1.23 

JC 

add  last  hit 

CSU  8.6.7.1.24  J 

1 

■  1 

“I 

f  report  last  hit 

V  CSU  8.6.7.1.25 

JC 

test  clutter 

CSU  8.6.7.1.26 

JC 

grid  locword  'N 

CSU  8.6.7.1.27  J 

1 

1 

■n 

A  fix  coords 

V  CSU  8.6.7.1.28 

JC 

check  tree  hit 
CSU  8.6.7.1.29 

JC 

diffraction  diff  'N 

CSU  8.6.7.1.30  J 

T 


Figure  2.6-24:  pve^checkvis.c  CSC  Structure  Part  1  of  2 
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T 


1 

1 

- 1 

r  check  box 

V  CSU  8.6.7.1.31 

JC 

count  vtxl 

CSU  8.6.7.1.32 

JC 

count  vtx2  hit  'N 

CSU  8.6.7.1.33  J 

1 

1  " 

1 

f  count_mid_hit 

JC 

report  edge  hit 

JC 

print  edge  ^ 

HI  IMP  ■ 

CSU  8.6.7.1.35 

CSU  8.6.7.1.36  J 

1  ■ 

- 1 

edge  z  miss 
CSU  8.6.7.1.38 

JC 

sort  trim  hits  A 

CSU  8.6.7.1.39  J 

1 

1 

f  print  object  into 

V  CSU  8.6.7.1.40 

JC 

debug  report 
CSU  8.6.7.1.41 

JC 

print  hitpt 

CSU  8.6.7.1.42  J 

1 

1 

1 

f  print_fpe_info 

JC 

print  pvparams 

JC 

print  short_pvparams  N 

V  CSU  8.6.7.1.43 

CSU  8.6.7.1.44 

CSU  8.6.7.1.45  ) 

1 

1 

1 

r  print  error 

V  CSU  8.6.7.1.46 

ISWiSgPl 

attenuation  factor 

CSU  8.6.7.1.48  J 

1 

- 1 - 

1 

f  print_5uard  info 

)C 

print  patch  info 

JC 

skyline  error 

V  CSU  8.6.7.1.49 

CSU  8.6.7.1.50 

CSU  8.6.7.1.51  ) 

1  “■ 

- T - 

■■  —1 

r  print  end  info 

JC 

vis  code 

JC 

report  vis  change  '\ 

V  CSU  8.6.7.1.52 

CSU  8.6.7.1.53 

CSU  8.6.7.1.54  ) 

1 

I 

1 

r  get  object  name 

JC 

interpolate 

JC 

print  terrain_point  'N 

V  CSU  8.6.7.1.55 

CSU  8.6.7.1.56 

CSU  8.6.7.1.57  J 

Figure  2.6-25:  pve_checkvis.c  CSC  Structure  Part  2  of  2 
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The  following  table  contains  the  constant  defines  in  pve_checlcvis.c  that  affect  compilation, 
and  subsequent  library  action.  With  them  are  their  current  values  and  a  brief  explanation  of 
their  meanings. 


Constant 

Value 

ALLOW  SEG  VIS 

1  r  Allow  the  use  of  segmented  intervis  math  V 

REPORT_BOTH_EDGE_BLOCKS 

1  r  Report  both  horizontal  and  vertical  grid  line 
blockage  in  test  minsOV 

TDB_2 

1  r  Use  new  database  format  for  Bergen.0102  and 

Knox  .030x*/ 

NEW  DIST 

1  /*  Use  new  distance  methods  in  checking  edges  V 

IGNORE_LOW_TREELINES 

ir  Treelines  below  MIN  TREELINE  HEIGHT  are 

PRINT  OBJECTS 


PRINT  ERRORS 


QUIT  ON  ERRORS 


DEBUG  PATCHES 


DEBUG  LIST  EDGES 


DEBUG  EDGES 


DEBUG  REPORT 


DEBUG  TREES 


DEBUG  CANOPIES 


DEBUG  HITS 


DEBUG  HITS  2 


DEBUG  TREE  OBJ  ELEVS 


DEBUG  ELEV 


DEBUG  MAX  ELEV 


DEBUG  ADD 


DEBUG  OBJECTS 


DEBUG  CLUTTER 


DEBUG  SWITCHES 


DEBUG  CLIP 


DEBUG  CHECK  BOX 


DEBUG  DIFFRACTION 


DEBUG  OBSTACLES 


DEBUG 


ignored  */ 


0  /*  Objects  are  not  printed  V 


0  r  Debugc^ng  errors  are  not  printed  */ 


0  r  Debugging  errors  don't  cause  terminations  */ 


0  /*  The  following  are  the  various  debug  code  */ 


0  r  defines.  Since  all  are  OFF  (undefined)  none  */ 


0  /*  of  debug  trapping  code  is  compiled.  In  V 


0  /*  addition,  the  constant  DEBUG  is  defined  */ 


0  /•  below  as  0.  since  it  is  the  product  of  the  logical  */ 


0  r  OR  of  the  other  smaller  debug  defines.  */ 


(DEBUG_PATCHES  ||  DEBUG_LIST_EDGES 
I  DEBUG.EDGES  1|  DEBUG_TREES 
I  DEBUG.CLUTTER  ||  DEBUG_OBJECTS 
I  DEBUG_CANOPIES  ||  DEBUG_SWITCHES 
I  DEBUG_HITS  ||  DEBUG_CLIP  ||  DEBUG_REPORT 
I  DEBUG_CHECK_BOX  ||  DEBUG_DIFFRACTION 
I  DEBUG_OBSTACLES 

I  DEBUG_TREE_OBJ_ELEVS  |I  DEBUG_ELEV 
I  DEBUG  MAX  ELEV  II  DEBUG  ADD) _ 


Table  2,6*307:  pve_checkvis.c  Test  and  Debug  Constant  Definitions 
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In  addition  to  the  constant  definitions  there  is  one  for  the  diffraction  boundary  weight  in  the 
following  table  and  values  for  the  ql_tbl  array.  (Sec  pve_checkvis.c  for  the  contents  of  the 
array.) 


Constant 

Value 

DIFFRAC  BDRY  WT 

100 

Table  2.6-308:  DIFFRAC  BDRY  WT  Constant  Derinition 


2.6.7. 1.1  pve_checkvis  CSU 


This  CSU  is  the  main  routine  for  checking  the  invisibilty  of  objects. 


1  Parameters  1 

1  Parameters  1 

Type 

Where  Tvpedef  Declared 

i  I'l  1  li  III'  1 

pointer  to  PV  PARAMS 

Sec.  2.6  7.4 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

DUMMY 

int 

Abnormal  end. 

FULLY  VISIBLE 

int 

Object  is  fully  visible. 

INVISIBLE 

int 

Object  is  invisible. 

visibility 

int 

Visibility  level. 

1  Errors  1 

Error  Name 

Reason  for  Error 

"error  opening  file  pvejDt_ 
stats" 

Unable  to  open  file  pve _pt_stats. 

"error  openinq  file  pve  stats" 

Unable  to  open  file  pve  stats. 

"NULL  pvparams  passed  to 
pve  checkvis.  Bve.." 

Null  pv  parameters  were  passed  to  pve.checkvis. 

"NULL  pointer  guardp  passed 
to  pve  checkvis.  Bve.." 

Null  pointer  guardp  was  passed  to  pve.checkvis. 

1  Calls  1 

1  Function 

Where  Described 

1  Mill  I'l  1 iiii 

Sec.  2.6.7.1.44 

startup 

Sec.  2.6.7.1.2 

test  mins 

Sec.  2.6.7.1.4 

diffraction  diff 

Sec.  2.6.7.1.30 

test  maxima 

Sec.  2.6  7.1. 5 

report  last  hit 

Sec.  2.6.7.1.25 

test  clutter 

Sec.  2.6.7.1.26 

print  end  info 

Sec.  2.6.7.1.52 

Table  2.6-309:  pve_checkvis  CSU  [8.6.7.1.1] 
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2. 6. 7. 1.2  startup  CSU 


This  CSU  sets  up  the  geometry  for  traversing  the  terrain  patches.  It  begins  point 
computations  where  the  ray  fiom  eye  to  target  hits  the  patch  boundaries.  It  terminates  the 
CSU  call  if  the  eye  is  to  close  to  the  target 


1  ReturnValues  1 

Return  Value 

Type 

Meanina 

TERMINATE 

static  int 

Abnormal  end. 

DUMMY 

static  int 

Normal  end. 

Errors 

Error  Name 

Reason  for  Error 

"unable  to  open  file  pve_ 
errors" 

Unable  to  open  file  pve_errors. 

Calls 

Function 

Where  Described 

max 

Sec.  2. 6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

clip  to  tdb 

Sec.  2.6.7.1.3 

PATCH  ROUND  UP 

Sec.  2.6.7.3  See  Appendix  A 

min 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

PATCH  ROUND  DOWN 

Sec.  2.6.7.3  See  Appendix  A 

DIST 

Sec.  2.6.7.3  See  Appendix  A 

Table  2.6-310:  startup  CSU  [8.6.7.1.21 


2. 6. 7. 1.3  clipjojdb  CSU 
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Calls 

Function 

Where  Described 

DIST 

tdb  get  z 

ISec.  2.21.7.16.2 

nnt  error 


max 


Sec.  2.6.7.1.46 


Sec.  2.6  7.3  &  Sec.  2.13.3.5  See 


ndix  A 


Table  2.6-311:  clipjojdb  CSU  [8.6.7.1.3] 


2.6.7. 1.4  test_inins  CSU 

This  CSU  checks  the  elevation  on  the  patch  boundaries. 


Return  Value 


BLOCKED 


DUMMY 


ReturnValues 


e 


static  int 


lEni 


static  int 


icmmir 


The  minimum  elevation  on  the 
boundary  is  above  the  ray  from 
the  eye  to  the  target  top  (so 
the  target  will  be  invisible). 


Any  other  situation. 


Function 


DIST 


PATCH  INDEX 


nnt  guard  info 


max 


Calls 


Where  Described 


Sec.  2.6.7.3  See  ADoendix  A 


Sec.  2.6.7.1.49 


Sec.  2.6.7.3  &  Sec.  2.13.3.5  See 


Table  2.6-312:  test_mins  CSU  18.6.7.1.4] 

2. 6. 7. 1.5  test_maxima  CSU 

This  CSU  computes  the  points  where  the  ray  hits  successive  patch  boundaries.  It  also 
computes  the  minimum  elevation  of  the  ray  in  the  patch,  and  checks  this  against  the 
maximum  elevation  of  terrain  polygons,  bounding  volumes,  and  trees. 


Return  Value 


nrin.TT 


ReturnValues 


static  int 


Meanin 


the  height  point 


Errors 

Error  Name 

Reason  for  Error 

"tdb  get  terrain  error" 

A  call  to  function  tdb  get  terrain  returned  NULL. 

"tdbjgetjerrain  on  ... 

A  call  to  function  tdb_get_terrain  returned  NULL. 

nx)ving  on  to  next  patch  ..." 
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1  Calls  1 

Function 

Where  Described 

DIST 

Sec.  2.6.7.3  See  Appendix  A 

min 

Sec.  2.6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

PATCH  INDEX 

print  quard  info 

Sec.  2.6.7.1.49 

max 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

fix  coords 

Sec.  2.6.7.1.28 

SCALE  COORDS 

Sec.  2.6  7.3 

grid  locword 

Sec.  2.6.7.1.27 

tdb  qet  terrain 

Sec.  2.21.7.18.1 

print  error 

Sec.  2.6.7.1.46 

tdb  error 

Sec.  2.21.7.17.1 

patch 

Sec.  2.6.7. 1.6 

Table  2.6-313:  test  maxima  CSU  [8.6.7.1.5] 


2. 6. 7. 1.6  patch  CSU 


This  CSU  checks  all  visibility  in  a  terrain  patch. 


1  Errors  I 

Error  Name 

Reason  for  Error 

‘results  overflow,  not  enough  memory  allocated  for 
PV_CHANGE_PTs  for  pve_checkvis 

Abandoning  computation  of  segmented  intervisibility" 

A  call  to  check  hits  returned 
RES_OFLOW. 

Calls 

Function 

Where  Described 

print  patch  info 

Sec.  2.6.7.1.50 

terrain 

Sec.  2.6.7.1.7 

objects 

Sec.  2.6.7.1.12 

trees 

Sec.  2.6.7.1.15 

treelines 

Sec.  2.6.7.1.16 

canopies 

Sec.  2.6.7.1.18 

sort  trim  hits 

Sec.  2.6.7.1.39 

check  hits 

Sec.  2.6.7.1.21 

Table  2.6-314:  patch  CSU  [8.6.7. 1.6] 


2.6.7. 1.7  terrain  CSU 


This  CSU  checks  the  terrain  edge  list  for  the  patch,  testing  edges  matching  grid_loc_word 
for  intervisibility  blocks. 


1  Calls  1 

Function 

Where  Described 

check_edges 

Sec.  2.6  7.1. 8 

Table  2.6-315:  terrain  CSU  [8.6.7.1.71 
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2. 6. 7. 1.8  check_edges  CSU 

This  CSU  checks  an  edge  list  for  the  patch,  testing  edges,  matching  grid_loc_wOTd  for 
intervisibility  blocks. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

edae 

register  int 

Standard 

*verticesp 

pointer  to  register 

TERRAIN  POINT 

terrain.h 

*edgesp 

pointer  to  register 

EDGE  DESCRIPTOR 

terrain.h 

register  int 

Standard 

1  Calls  1 

Function 

Where  Described 

print  edae 

Sec.  2.6.7.1.36 

edqe  alw  miss 

Sec.  2.6.7.1.37 

edge  z  miss 

Sec.  2.6.7.1.38 

POINT  TO  LINE 

report  edge  hit 

Sec.  2.6.7.1.35 

count  vtxl  hit 

Sec.  2.6.7.1.32 

check  edge  hit 

Sec.  2.6.7.1.11 

DIST 

Sec.  2  6.7.3  See  Appendix  A 

count  vtx2  hit 

Sec.  2.6.7.1.33 

count  mid  hit 

Sec.  2.6.7.1.34 

get  mid  pt 

Sec.  2.6.7.1.9 

compute  mid 

Sec.  2.6.7.1.10 

Table  2.6-316:  check_edges  CSU  [8.6.7.1.81 


2.6.7. 1.9  get_mid_pt  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*newptp 

pointer  to  TERRAIN  POINT 

terrain.h 

*pt1p 

pointer  to  TERRAIN  POINT 

terrain.h 

*pt2p 

pointer  to  TERRAIN  POINT 

terrain.h 

lambda 

register  double 

Standard 

Table  2.6-317:  get_mid_pt  CSU  [8.6.7.1.9] 
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2.6.7.1.10  compiite_mid  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*midpointp 

pointer  to  register 

TERRAIN  POINT 

terrain,  h 

*point1p 

pointer  to  register 

TERRAIN  POINT 

terrain.h 

weiQhtI 

register  double 

Standard 

*point2p 

pointer  to  register 

TERRAIN  POINT 

terrain.h 

Table  2.6-318:  compute_inid  CSU  [8.6.7.1.10] 


2.6.7.1.11  check_edge_hit  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*pointp 

pointer  to  register 

TERRAIN  POINT 

terrain.h 

register  int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

TERMINATE 

int 

Checking  point-to-point  only 
and  visibility  is  zero. 

DUMMY 

int 

Normal  end. 

1  Calls  1 

Function 

Where  Described  1 

DIST 

print  terrain  point 

Sec.  2.6.7.1.57 

report  vis  change 

Sec.  2.6.7.1.54 

max 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

store  hit 

Sec.  2.6.7.1.19 

Table  2.6-319:  check_edge_hit  CSU  [8.6.7.1.11] 


I 
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2.6.7.1.12  objects  CSU 


This  CSU  checks  the  bounding  volumes. 


1  Calls  1 

Function 

Where  Described 

GET  OBJECT  MIN  X 

terrain,  h 

GET  OBJECT  MIN  Y 

terrain.h 

GET  OBJECT  MAX  X 

terrain.h 

GET  OBJECT  MAX  Y 

terrain.h 

GET  OBJECT  MAX  Z 

terrain.h 

GET  OBJECT  TYPE 

terrain.h 

check  box 

Sec.  2.6.7.1.31 

obstacle 

Sec.  2.6.7.1.13 

check  object 

Sec.  2.6.7.1.14 

Table  2.6-320:  objects  CSU  [8.6.7.1.12] 


2.6.7.1.13  obstacle  CSU 


1  Calls  1 

Function 

Where  Described 

DIST 

Sec.  2.6.7.3 

min 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Aooendix  A 

Table  2.6-321:  obstacle  CSU  [8.6.7.1.13] 


2.6.7.1.14  check_obJect  CSU 

This  CSU  tests  the  given  object  for  a  visibility  blockage. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

'objectp 

pointer  to 

OBJECT  DESCRIPTOR 

terrain.h 

Calls 

Function 

Where  Described 

print  object  info 

Sec.  2.6.7.1.40 

DIST 

Sec.  2.6  7.3 

POINT  TO  LINE 

Sec.  2.6.7.3  See  Appendix  A 

max 

Sec.  2. 6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

store  hit 

Sec.  2.6.7.1.19 

Table  2.6-322:  check_obJect  CSU  [8.6.7.1.14] 
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2.6.7.1.15  trees  CSU 

This  CSU  checks  trees.  A  tree  is  modeled  as  a  triangle  T_LINE_BOT_WINDOW  above 
the  ground.  z_hit  is  not  quite  correct  as  ground  height,  but  it  is  used  anyway.  This  is  not  a 
problem  for  point-to-point  intervisibility.  z_hit  is  correct  if  the  ground  is  flat  or  dotl  is  0. 


1  calls  1 

Function 

Where  Described 

DIST 

Sec.  2.6  7.3 

check  tree  hit 

Sec.  2.6.7.1.29 

abs 

Sec.  2.6.7.3  &  Sec.  2.13.3.2  See  Appendix  A 

Table  2.6-323:  trees  CSU  [8.6.7.1.15] 


2.6.7.1.16  treelines  CSU 

If  the  ray  goes  through  the  guard  box  around  the  treeline,  this  CSU  checks  for  blockage  at 
the  tree  at  each  end  of  the  treeline,  and  for  blockage  in  the  segments.  It  terminates  if  there 
are  one  or  fewer  segments. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

num  tiines 

register  irt 

Standard 

Mreelinep 

pointer  to  register 

TREELINE  HEADER 

terrain.h 

1  Errors  1 

Error  Name 

Reason  for  Error 

"treeline  error,  treeline" 

There  are  one  or  fewer  treeline  vertices. 

"treeline  error:  ...  vertices 
from ...  to ... 
last:  ....  next:  ..." 

There  are  one  or  fewer  treeline  vertices. 

1  Calls  1 

Function 

Where  Described 

check  box 

Sec.  2.6.7.1.31 

print  error 

Sec.  2.6.7.1.46 

POINT  TO  LINE 

Sec.  2. 6.7.3  See  Appendix  A 

DIST 

Sec.  2.6.7.3  See  Appendix  A 

check  tree  hit 

Sec.  2.6.7.1.29 

compute  mid 

Sec.  2.6.7.1.10 

Table  2.6-324: 


treelines  CSU  [8.6.7.1.16] 
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2.6.7.1.17  report__tree_block  CSU 


This  CSU  puts  a  tree  hit  in  the  PV_RESULT  strucmre.  It  is  called  only  if  params->num_ 
trees  <  PV_MAX_TREE_BLC)CKS  (which  means  that  more  tree  blocks  may  be  reported) 
or  if  this  tree  is  closer  than  the  furthest  one  previously  reported. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

X 

REAL  4 

mass  stdc.h 

V 

REAL  4 

mass  stdc.h 

dist 

double 

Standard 

Calls 

Function 

Where  Described 

min 

Sec.  2.6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

tree  dist 

Table  2.6-325:  report_tree_block  CSU  [8.6.7.1.17] 


2.6.7.1.18  canopies  CSU 

This  CSU  checks  the  canopy  edge  list  for  the  patch,  testing  edges  matching  grid_loc_word 
for  intervisibility  blocks. 


1  Calls  1 

Function 

Where  Described 

check  box 

Sec.  2.6.7.1.31 

treelines 

Sec.  2.6.7.1.16 

check  edges 

Sec.  2.6.7.1.8 

Table  2.6-326:  canopies  CSU  [8.6.7.1.18] 


2.6.7.1.19  store_hit  CSU 

This  CSU  stores  a  hit  point  as  follows:  For  objects,  z  represents  the  elevation  of  the  top 
with  z_b_in  and  z_b_out  representing  surface-level  elevations  relative  to  z_from.  For 
trees,  z_b_in  is  surface  elevation,  z  is  top  elevation,  z_b_out  is  the  elevation  of  the  bottom 
of  the  foliage,  T_LINE_BOT_WlNDOW  above  the  ground.  For  tree  canopies  and  terrain 
edges,  though,  z  equals  z_b_in  equals  z_b_out.  In  particular,  for  canopy  ^ges  the  ground 
elevation  is  unknown. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

X 

double 

Standard 

V 

double 

Standard 

z 

double 

Standard 

z  b  in 

double 

Standard 

z  b  out 

double 

Standard 

int 

Standard 

d 

double 

Standard 

ratio 

double 

Standard 
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Errors 

Error  Name 

Reason  for  Error 

"OVERFLOW. ...  hits  in  patch,  at ... 

Only ...  hits  may  be  recorded  in  a  patch* 

Total  hits  exceeded  maximum  hit  points. 

Table  2.6-327:  store_hit  CSU  [8.6.7.1.19] 

2.6.7.1.20  average  CSU 

This  CSU  computes  the  linearly  weighted  average  of  elevations  zl  at  distance  dl  and  z2  at 
distance  d2,  at  an  intermediate  distance  d3. 


Parameters 


zi 


dl 


z2 


d2 


d3 


Return  Value 


z1  +z2)/2 


Parameters 


reoister  double 


reoister  double 


reoister  double 


register  double 


register  double 


iBn 


static  double 


static  double 


ReturnValues 


Where  Tyoedef  Declared 


Standard 


Standard 


Standard 


Standard 


Standard 


Meanin 


dl  and  d2  are  about  egual. 


Linearly  weighted  average. 


Table  2.6-328:  average  CSU  [8.6.7.1.20] 

2.6.7.1.21  check_hits  CSU 

This  CSU  checks  the  hits  for  a  given  patch,  reporting  any  changes  in  visibility.  No 
distinction  is  made  between  full  and  partial  tree  blocks.  All  tree  blocks  are  called  partial. 
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1  Calls  1 

Function 

Where  Described 

vis  code 

Sec.  2.6.7.1.53 

report  hit 

Sec.  2.6.7.1.22 

max 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

Table  2.6-329:  check  hits  CSU  [8.6.7.1.21] 


2.6.7.1.22  report_hit  CSU 


1  ReturnValues  1 

Return  Value 

Type 

Meaning 

TERMINATE 

static  int 

Any  of  variousdistance 
variables  is  greater  than  total 
distance. 

DUMMY 

static  int 

Standard 

Errors 

Error  Name 

Reason  for  Error 

"***  skyline  error  in  report  hit" 

Case  is  INVISIBLE  and  skyline  denom  <=  0. 

"skyline  error" 

Case  is  INVISIBLE,  and  skyline_denom  <=  0; 
or 

case  is  FULL_BLK_TREES, 
or 

case  is  PT_BLK_SOLID„PT_BLK_TREES 
and  skyline_denom  <®  0; 
or 

case  is  PT  BLK  TREES  and  skyline  denom 
>=0; 
or 

case  is  PT  BLK  SOLID  and  do  trees  = 

TRUE: 

or 

case  is  PT_BLK_SOLID  and 
inv _part_solid_dist  >  currp->dist; 
or 

case  is  PT_BLK_SOLID  and 
vis j3art_solid_dist  >  currp->dist; 
or 

case  is  PT_BLK_SOLID  and 
not(skyline_denom  <  0  &&  currvis  «- 
INVISIBLE)  and  not  (skyline  denom  >  0  && 
currvis  ==  FULLY_VISIBLE); 
or 

case  is  FULLY  VISIBLE  and  skyline  denom 
>=  0. 

"case  error,  report_hit" 

The  value  in  old  vis  is 

PT  BLK  SOLID  FULL  BLK  TREES. 

Table  2.6-330  is  continued  on  the  following  page 
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"pve_checkvis:  skyline  error  in  report_hir 

is 

PT_BLK_S0LID_FULL_BLK_TREES: 

or 

case  is  PT_BLK_SOLID_PT_BLK_TREES 
and  skyline_denom  <>  0; 
or 

case  is  PT  BLK  TREES  and  skyline  denom 
>-0; 
or 

case  is  FULLY  VISIBLE  and  skyline  denom 
>-0. 

"pve.checkvis:  skyline  error  in  report.hit 
report_hit  error:  old_vis ...  case  not 
imolemented" 

Case  is  FULL_BLK_TREES. 

"pve_checkvis:  treeline  error  in  report.hit” 

Case  is  PT  BLK  TREES  and  treeline  denom 
<-0. 

Ireeline  error” 

Case  is  PT  BLK  TREES  and  treeUne  denom 
<-0. 

"report_hits  error" 

Case  is  PT_BLK_TREES  and 
vis  Dart  tree  dist  >  curTD->dist. 

"***  ERROR  in  report_hits 

Case  is  PT_BLK_TREES  and 
vis  part  tree  dist  >  currp->dist. 

"pve  checkvis:  report  hit  error: 

PART  BLK  SOLID  &  do  trees" 

Case  is  PT  BLK  SOLID  and  do  trees  = 

TRUE. 

"pve  checkvis:  skyline  error  in  report  hit, 
Old_vis  PT_BLK_SOLID" 

Case  is  PT_BLK_SOLID  and 
inyj)art_soBd_dist  >  currp->dist; 
or 

case  is  PT_BLK_SOLID  and 
vis_part_solid_dist  >  currp->dist; 
or 

case  is  PT_BLK_SOLID  and 
not(skytine_denom  <  0  &&  currvis  == 

INVISIBLE)  and  not  (skyline  denom  >  0  && 
currvis  —  FULLY  VISIBLE). 

"pve_checkvis:  unknown  case  in  report_hit" 

Value  of  old.vis  is  none  of  the  expected 
visibilities. 

"report_hit  error:  unknown  case:  hits  ..." 

VaKie  of  old_vis  is  none  of  the  expected 
visibilities. 

"unknown  case  in  report_hit" 

Value  of  old_vis  is  none  of  the  expected 
visibilities. 

Calls 

Function 

Where  Described 

Dtlnt  hitot 

Sec.  2.6.7.1.42 

debug  report 

Sec.  2.6.7.1 .41 

Drint  ch  Dt  info 

Sec.  2.6.7.1.23 

Drint  error 

Sec.  2.6.7.1.46 

skyline  error 

Sec.  2.6.7.1.51 

XC 

Sec.  2.6.7.3  See  Aooendix  A 

YC 

Sec.  2.6.7.3  See  AoDerxIix  A 

vis  code 

Sec.  2.2.6.7.1.53 

Table  2.6-330;  report_hit  CSU  [8.6.7.1.22] 
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2.6.7.1.23  print_ch_pt_info  CSU 
This  CSU  writes  change-point  information  to  a  file. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*fp 

pointer  to  FILE 

Standard 

ch  dist 

double 

Standard 

ch  vis 

int 

Standard 

1  Calls  1 

Function 

Where  Described  1 

XC 

YC 

Sec.  2.6.7.3  See  Appendix  A 

vis  code 

Sec.  2.6.7.1.53 

Table  2.6>331:  print_ch_pt_info  CSU  [8.6.7.1.23] 


2.6.7.1.24  add  last  hit  CSU 


1  Errors  1 

Error  Name 

Reason  for  Error  I 

"add  last  hit  error" 

1  Calls  1 

Function 

Where  Described 

print  error 

Sec.  2.6.7.1.46 

print  .hitpt 

Sec.  2.6.7.1.42 

Table  2.6-332:  add  last  hit  CSU  [8.6.7.1.24] 


2.6.7.1.25  report_last_hit  CSU 


1  Errors  1 

Error  Name 

Reason  for  Error 

"seavis  !=  ptvis  error" 

old  vis  and  possibly  see  under  tree  have  improper  values. 

1  Calls  1 

Function 

Where  Described 

print  error 

Sec.  2.6.7.1.46 

Sec.  2.6.7.1.56 

IDIST 

Table  2.6-333:  report_last_hit  CSU  [8.6.7.1.25] 
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2.6.7.1.26  test_clutter  CSV 

This  CSU  checks  from  target  position  to  the  edge  of  the  tdb  to  see  if  a  terrain  patch  behind 
the  target  is  above  the  line  of  sight  from  eye  to  the  t(^  of  the  target 


1  Calls  1 

Function 

Where  Described 

DIST 

Se:  2  6.7.3  See  Aopendix  A 

STILL  IN  BOUNDS  X 

Sec.  2.6.7.3  See  Appendix  A 

STILL  IN  BOUNDS  Y 

Sec  2  6.7.3  See  Appendix  A 

PATCH  INDEX 

r  in  MCC  CSCI  SDD 

Drint  quard  info 

Si:  2.6.7.1.49 

Table  2.6-334:  test  clutter  CSU  [8.6.7.1.26] 


2.6.7.1.27  grid_locworc  CSU 

This  CSU  looks  up  the  grid  lo.  tor  word  of  the  ray  between  a  point  on  edge  l  with 
coordinate  coord J,  to  edge_2. ;  oord_2.  Edges  are  called  PVE_LEFT,  PVE_TOP, 
PVE_RIGHT,  and  PVE_B0T:  jM.  Coordinates  are  measured  from  the  bottom  or  left, 
and  are  0, 1, 2, ...  (PV_REF_C  R_NUM  - 1).  Caller  is  responsible  for  ensuring  that  these 
coordinates  aie  integers  in  this  range. 


PV_REF_GR_NUM  =  ""  N’EMENT_LEVEL  *  PV_GRID_NUM 
PV_GRID_NUM  is  the  r  of  squares  along  an  edge  of  the  grid  that  is  used  in  the 
definition  of  the  grid  la  ord. 


1  Parameters  I 

Parameters 

ype 

Where  Typedef  Declared 

edge  1 

-•t 

Standard 

1  coord  1 

Standard 

edge  2 

:nt 

Standard 

coord 2 

snt 

Standard 

1  ReturnVaiues  1 

Return  Value 

Meaning 

PVE_QLW_LEFT 

static  unsigned 

Case  edge  1.  PVE  LEFT, 
edge  2.  PVE  LEFT. 

static  unsigned 

All  other  known  cases. 

PVE  GLW  ERROR 

static  unsigned 

Unknown  cases. 

PVE_GLW_TOP 

static  unsigned 

Case  edge  1,  PVE  TOP, 
edge  2.  PVE  TOP. 

PVE_GL\W_  RIGHT  |  static  unsigned 

Case  edge  I.PVE  RIGHT, 
edge  2.  PVE  RIGHT. 

PVE_GLW_BOTTOM 

static  unsigned 

Case  edge  1 , 

PVE  BOTTOM,  edge  2. 

PVE  BOTTOM. 

Table  2.6-335:  gridjocword  CSU  [8.6.7.1.27] 
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2.6.7.1.28  fix_coords  CSU 


This  CSU  computes  last_coord_dbl  and  next_cooid_dbl  (patch  coordinates).  They  are 
doubles  between  0  and  patch_size.  last_coOTd_dbl  is  modified  slighdy  to  oisure  tliat  it  will 
represent  patch  cocxdinates  in  the  patch  of  mid. 


1  Calls  I 

Function 

Where  Described  1 

PATCH  CCX)RD 

Table  2.6-336:  flx  coords  CSU  [8.6.7.1.28] 


2.6.7.1.29  clieckjree_hit  CSU 

For  point-to-point  intervisibility,  this  CSU  reports  a  partial  tree  block  if: 
the  bottom  of  the  tree  is  below  the  top  of  the  target  and 
the  top  of  the  tree  is  above  the  bottom  of  the  target; 
reports  a  full  tree  block  if: 

the  bottom  of  the  tree  is  below  the  bottom  of  the  target  and 
the  top  of  the  tree  is  above  the  top  of  the  target. 


It  does  not  check  cumulative  effects  of  more  than  one  tree,  which  might  give  a  full  t 
block  by  a  combination  of  partial  blocks.  All  elevations  are  relative  to  z_from. 


1  Parameters  1 

Parameters 

Type. 

Where  Typedef  Declared 

X 

double 

Standard 

y 

double 

Standard 

dist 

register  double 

Standard 

tree  top 

register  double 

Standard 

tree  bot 

register  double 

Standard 

around  elev 

register  double 

Standard 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

max 

Sec.  2.6.7.3  &  Sec.  2.13.3.5  See  Appendix  A 

store  hit 

Sec.  2.6.7.1.19 

report  tree  block 

Sec.  2.6.7.1.17 

Table  2.6-337:  check _tree_hit  CSU  [8.6.7.1.29] 


2.6.7.1.30  diffraction  diff  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

forward  ratio 

double 

Standard 

reverse  .ratio 

double 

Standard 
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1  ReturnValues  \ 

Return  Value 

Type 

Meanina 

0.0 

static  double 

forward_ratio  <=  top_ratio  or 
numer  qround  <=  0. 

dist 

static  double 

Normal  end. 

Calls 

Function 

Where  Described 

attenuation  factor 

Sec.  2.6.7.1.48 

Table  2.6-338:  diffraction_<liff  CSU  [8.6.7.1.30] 


2.6.7.1.31  check_box  CSU 

This  CSU  returns  a  if  a  line  through  (x_last,  y_last)  perpendicular  to  the  vector  (x_nonnal, 
y_normal)  intersects  the  box  with  comers  (x_min,  y_inin),  (x_max,  y_min),  (x_max, 
y_max),  (x_min,  y_max).  For  floating  point  error  reasons,  it  tests  for  product  < 
EPSI_^SI  rather  than  product  <  0. 


Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

X  min 

reaister  REAL  4 

mass  stdc.h 

V  min 

reoister  REAL  4 

mass  stdc.h 

X  max 

reqister  REAL  4 

mass  stdc.h 

V  max 

reoister  REAL  4 

mass  stdc.h 

ReturnValues  I 

Return  Value 

Type 

1 

int 

Line  intersects  box. 

0 

int 

Line  does  not  intersect  box. 

Table  2.6-339:  check_box  CSU  [8.6.7.1.31] 


2.6.7.1.32  count  vtxl  hit  CSU 


This  CSU  increments  the  count  of  terrain  or  canopy  vtxl -hits. 


I  Parameters  I 

■  Parameters 

Where  Typedef  Declared 

int 

Standard 

Table  2.6-340;  count_vtxl  hit  CSU  [?????] 
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2.6.7.1.33  count  vtx2  hit  CSU 


This  CSU  increments  the  count  of  terrain  or  canopy  vtx2-hits. 


1  Parameters  1 

1  Parameters 

Type 

Where  Tvoedef  Declared 

int 

Standard 

Table  2.6-341:  count  vtx2  hit  CSU  [?????] 


2.6.7.1.34  count_niid_hit  CSU 

This  CSU  increments  the  count  of  terrain  or  canopy  mid-hits. 


1  Parameters  1 

■  Parameters  1 

Type 

Where  Tvpedef  Declared 

int 

Standard 

Table  2.6-342:  count  mid  hit  CSU  [?????] 


2.6.7.1.35  report_edge_hit  CSU 

This  CSU  writes  to  a  file:  message,  edge,  dot,  and  the  x,  y,  z,  and  (z  -  z_from)  for  the 
vertex  point  for  an  edge  hit. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

*msg 

pointer  to  char 

Standard 

edge 

int 

Standard 

*vertD 

pointer  to  TERRAIN  POINT 

terrain,  h 

dot 

double 

Standard 

Table  2.6-343:  report_edge_hit  CSU  [?????] 


2.6.7.1.36  print_edge  CSU 

This  CSU  writes  to  a  file:  x,  y,  z,  and  (z  -  z_from)  for  the  two  vertices  forming  an  edge. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

edge 

int 

Standard 

•vertex  Ip 

pointer  to  TERRAIN  POINT 

terrain.h 

*vertex2p 

pointer  to  TERRAIN  POINT 

terrain.h 

Table  2.6-344:  print_edge  CSU  [?????] 
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2.6.7.1.37  edge_glw_iniss  CSU 

This  CSU  writes  to  a  file  the  grid  loc  word  miss  for  edge,  edge_glw,  and  ray_glw. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

edae 

int 

Standard 

edae  qIw 

HWORD 

mass  stdc.h 

ray  qlw 

HWORD 

mass  stdc.h 

Table  2.6-345:  edge_glw_iniss  CSU  [?????] 


2.6.7.1.38  edge_z_iniss  CSU 

This  CSU  writes  to  a  file  the  elevation  miss  of  an  edge,  and  z_ray_min. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

edae 

int 

Standard 

Table  2.6-346:  edge_z_iniss  CSU  [?????] 


2.6.7.1.39  sort_trim_hlts  CSU 


1  Errors  I 

Error  Name 

Reason  for  Error 

"sort  error 

(currp->dist  +  EPSI_EPSI)  <  header_hitp- 
>nexto->dist 

"sort  error:  currdist...  firstdist... 
currp  header  hitp->nextp  ... 

{currp->dist  +  EPSI_EPSI)  <  header_hitp- 
>nextp->dist 

"terr_nextp  case  error 

Value  in  currp->type  is  none  of  the  expected 
types. 

"terr_nextp  case ...  error  in  standard  branch; 
surrp ....  terr_nextp ... 

currp  dist ....  terr  nextp  dist ..." 

Value  in  currp->type  is  none  of  the  expected 
types. 

"pve_checkvis:  terr_nextp  case  error 

Value  in  currp->type  is  none  of  the  expected 
types. 

"tdb  aet  z  error  at ..." 

A  call  to  function  tdb  aet  z  returned  -1 . 

"tdb  aet  z  error 

A  call  to  function  tdb  aet  z  returned  -1 . 

Calls 

Function 

Where  Described 

print  debua  list 

Sec.  2.6.7.1.47 

print  error 

Sec.  2.6.7.1.46 

averaae 

Sec.  2.6.7.1.20 

tdb  aet  z 

Sec.  2.21.7.16.2 

max 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

add  last  hit 

Sec.  2.6.7.1.24 

Table  2.6-347:  sort  trim  hits  CSU  [?????! 
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2.6.7.1.40  print_object_info  CSU 

This  CSU  writes  to  a  file  the  name,  height,  type,  and  vertices  of  an  object 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*fp 

pointer  to  FILE 

Standard 

*objp 

pointer  to 

OBJECT  DESCRIPTOR 

terrain.h 

I  Calls  I 

Function 

Where  Described 

qet  object  name 

Sec.  2.6.7.1.55 

GET  OBJECT  TYPE 

terrain.h 

Table  2.6-348:  print_object_info  CSU  [?????] 


2.6.7.1.41  debug_report  CSU 


This  CSU  writes  to  a  file  debug  information  as  directed  by  the  argument  n.  For  n  =1, 
distance,  visibility,  and  skyline-ratios  are  written.  For  n=2,  variables  of  the  types 
.skyline,  numer_,  and  _denom  are  written. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

n 

int 

Standard 

Table  2.6-349:  debug_report  CSU  [?????! 


2.6.7.1.42  pnnt_hitpt  CSU 

This  CSU  writes  to  a  file  hit  point  information  from  a  PV_HIT_PT  data  structure. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•pointp 

pointer  to  PV  HIT  PT 

Sec.  2.6.7.4 

Table  2.6-350:  print.hitpt  CSU  [?????] 


2.6.7.1.43  print_fpe_info  CSU 
This  CSU  writes  to  a  file  fpe  error  information. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

visi 

int 

Standard 

vis2 

int 

Standard 
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1  Errors  1 

Error  Name 

Reason  for  Error 

"error  openino  file  pve  stats* 

Unable  to  open  file  pve  stats  to  write. 

Table  2.6-351:  printjpejnfo  CSU  [?????] 


2.6.7.1.44  print_pvparains  CSU 

This  CSU  writes  to  a  file  information  from  a  PV_PARAMS  data  structure. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

•file 

pointer  to  FILE 

Standard 

•params 

pointer  to  PV  PARAMS 

Sec.  2.6  7.4 

Table  2.6-352:  print_pvparanis  CSU  I?????] 


2.6.7.1.45  print_short_pvparams  CSU 

This  CSU  writes  to  a  file  only  the  visibility  test  information  from  a  PV_PARAMS  data 
structure. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•file 

pointer  to  FILE 

Standard 

•params 

pointer  to  PV  PARAMS 

Sec.  2.6.7  4 

Table  2.6-353:  prmt_short_pvparams  CSU  [?????] 


2.6.7.1.46  print_error  CSU 


This  CSU  writes  to  a  file  an  error  message  with  distances  and  visibilities  and  then  calls 
print_short_pvparams  to  write  visibility  test  information 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

:tP 

pointer  to  FILE 

Standard 

pointer  to  char 

Standard 

dist1 

double 

Standard 

dist2 

double 

Standard 

flao 

unsigned  int 

Standard 

I  Calls  I 

Function 

Where  Described 

print  short  pvparams 

Sec.  2.6.7.1.45 

Table  2.6-354:  print_error  CSU  [?????! 


► 
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2.6.7.1.47  print_debug_llst  CSU 


This  CSU  writes  to  a  file  a  list  of  hit  points,  exiting  with  condition  code  1  if  it  fuids  a  cell 
pointing  to  itself. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*hitp 

pointer  to  PV  HIT.PT 

Sec.  2.6.7.4 

1  Calls  1 

Function 

Where  Described 

print,  hitpt 

Sec.  2.6.7.1.42 

Table  2.6-355:  print_debugjist  CSU  [?????] 


2.6.7.1.48  attenuation  factor  CSU 


This  CSU  computes  the  attenuation  factor  for  radio  transmissions  partially  blocked  by 
terrain  or  obstacles. 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

distance 

double 

Standard 

frequency 

double 

Standard 

I  ReturnValues  I 

Return  Value 

Meaning 

1.0 

static  double 

Wavelength  or  distance  near 
zero. 

4.0  +  distance*  195 

static  double 

distance  <  0.01 

5.12  +  distance*83.5 

static  double 

0.01  <=  distance  <  0.09 

5.86  +  distance*75.23 

static  double 

0.09  <=  distance  <1.0 

2.47  +  distance*78.629 

static  double 

1 .0  <=  distance 

Table  2.6-356:  attenuation  factor  CSU  [8.6.7.1.31] 


2.6.7.1.49  print_guard_info  CSU 


This  CSU  writes  to  a  file  patch  guard  information  from  a  PATCH_GUARD  data  structure. 


j  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*patch  quardp 

pointer  to  PATCH  GUARD 

ferrain.h 

patch  num 

int 

Standard 

Table  2.6-357:  print_guard_info  CSU  [?????] 
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2.6.7.1.50  print_patch_info  CSU 

This  CSU  writes  to  a  file  patch  information  from  EDGE_DESCRIPTOR  and 
TERRAIN_POINT  data  structures.  This  CSU  has  no  parameters,  returns  no  values,  and 
calls  no  other  CSUs. 


2.6.7.1.51  skyline_error  CSU 


This  CSU  writes  to  a  file  skyline  enx)r  information  including  visibility  codes  and  hit  points, 
and  calls  print_pvparams  to  write  visibility  data. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

oldvis 

int 

Standard 

curvis 

int 

Standard 

denom 

double 

Standard 

•ohitp 

pointer  to  PV  HIT  PT 

Sec.  2.6.7.4 

*nhitp 

pointer  to  PV  HIT  PT 

Sec.  2.6.7.4 

out  pt 

int 

Standard 

1  Errors  I 

Error  Name 

Reason  for  Error 

"cant  open  file  pve  sky  errs" 

Unable  to  open  file  pve  sky  errs  for  appendinq. 

1  Calls  1 

Function 

Where  Described 

vis  code 

Sec.  2.6.7.1.53 

1  lilill  I'l  11^  liil  — 

Sec.  2.6.7.1.44 

Table  2.6-358:  skyline_error  CSU  [?????] 


2.6.7.1.52  print_end_info  CSU 

This  CSU  writes  to  a  file  wrapup  information  on  pv  parameters,  ratios,  visibilities,  and 
attenuation. 


1  Errors  1 

■  Error  Name 

Reason  for  Error 

Unable  to  open  file  pve  sky  errs  for  appendinq. 

"error:  returns  ....  segLVis  .... 

Segmented  visibility  is  different  from  pt-to-pt  visibility  and 

in:" 

different  from  pt-tOHDt  visibility  with  4  bit  on. 

1  Calls  1 

■  Function 

Where  Described 

■  hlill  1'  Ih'liil  — 

Sec.  2.6.7.1.44 

■  attenuation  factor 

Sec.  2.6.7.1.48 

Table  2.6-359:  print_endJnfo  CSU  [?????] 
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2.6.7.1.53  vis  code  CSU 


This  CSU  converts  an  integer  visibility  code  to  a  character  string. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

code 

int 

Standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

"FULLY  VISIBLE" 

pointer  to  char 

code  « 15 

"PT  BLK  SOLID" 

pointer  to  char 

code  - 13 

"PT  BLK  TREES" 

pointer  to  char 

code  =  7 

"PT  BLK  SOLID  PT  BLK 
TREES" 

pointer  to  char 

code  -5 

"FULL  BLK  TREES" 

pointer  to  char 

code  =  3 

pointer  to  char 

code  =  1 

"INVISIBLE" 

pointer  to  char 

code  B  0 

"Unknown  vis  code" 

pointer  to  char 

Unknown  code. 

Table  2.6-360:  vis  code  CSU  t7???71 


2.6.7.1.54  report_vis_change  CSU 
This  CSU  writes  to  a  file  the  present  visibility. 


366 


BBN  Systems  and  Technologies _ SAP  Simulation  Host  CSCI 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

"church" 

pointer  to  static  char 

object  type  *  CHURCH 

"guard  tower" 

pointer  to  static  char 

object  type  « 

GUARD  TOWER 

"house" 

pointer  to  static  char 

object  type  -  HOUSE 

"mobile  home" 

pointer  to  static  char 

object  type  - 
MOBILE  HOME 

pointer  to  static  char 

object  type  * 

OFFICE  BUILDING 

"one  story  barracks" 

pointer  to  static  char 

object  type  « 

ONE  STORY  BARRACKS 

"power  tower" 

pointer  to  static  c^ar 

object  type  « 

POWER  TOWER 

"small  house" 

pointer  to  static  char 

object  type  « 

SMALL  HOUSE 

“two  story  barracks" 

pointer  to  static  char 

object  type  ^ 

TWO  STORY  BARRACKS 

"water  tower" 

pointer  to  static  char 

Object  type  « 

WATER  TOWER 

"object ..." 

pointer  to  static  char 

object_type  is  none  of  the 
above. 

Table  2.6-362:  get_object_name  C 

2.6.7.1.56  interpolate  CSU 

ITiis  CSU  returns  val_mid,  interpolating  from  vai  l  at  u_l 
only  when  u_l  and  u_2  differ  by  more  than  EPSILON. 

SU  [?????] 

and  val_2  at  «_2.  It  worics 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

u  1 

reqister  double 

Standard 

U  2 

register  double 

Standard 

u  mid 

register  double 

Standard 

val  1 

register  double 

Standard 

val  2 

register  double 

Standard 

I  ReturnVatues  I 

Return  Value 

Meaning 

(val  1  +  val  2)  /  2 

double 

u  1  and  u  2  are  nearly  egual. 

double 

All  other  conditions. 

Table  2.6-363:  interpolate  CSV  [?????] 
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2.6.7.1.57  print_terrain_point  CSU 

This  CSU  writes  to  a  file  x,  y,  and  z  from  a  TERRAIN_POINT  data  structure  to  a  file. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*fp 

pointer  to  FILE 

Standard 

*pointD 

pointer  to  TERRAIN  POINT 

terrain.h 

Table  2.6>364:  print_terrain_point  CSU  [?????] 


2. 6. 7. 2  pv__bv.c  CSC 

/simnet/libsrc/libpvis;^v_bv.c 

This  CSC  contains  two  CSUs,  described  below. 


pv_bv.c 

CSC 

8.6.7.2 

zznz 


CpointJn_bv  ^ 

CSU  8.6.7.2.1  J 


c 


1 


injobjecti  N 

CSU  8.6.7.2.2  J 


Figure  2.6-26:  pv_bv.c  CSC  Structure 
In  addition,  the  CSC  contains  a  single  constant  definition  in  the  following  table. 


Constant 

Value 

OBSTACLE  EXPANSION 

3.0  r  meters  to  add  to  obstacle  */ 

Table  2.6-365:  pv_bv.c  Constant  Definition 


2. 6. 7. 2.1  point_in_bv  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*position 

pointer  to  double 

Standard 

ReturnValues 

Return  Value 

Type 

Meaning 

TRUE 

int 

Objects  present. 

FALSE 

int 

No  objects  to  start. 

Errors 

Error  Name 

Reason  for  Error 

Tdb  aet  terrain  error  at ..." 

A  call  to  function  tdb  aet  terrain  returned  NULL. 
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Calls 

Function 

Where  Described 

tdb  oet  terrain 

Sec.  2.21.7.18.1 

GET  OBJECT  MAX  X 

terrain.h 

GET  OBJECT  MIN  X 

terrain. h 

GET  OBJECT  MAX  Y 

terrain.h 

GET  OBJECT  MIN  Y 

terrain.h 

Table  2.6-366:  poinMn_bv  CSU  [8.6.7.2.1] 


2.6.7. 2. 2  in_object2  CSU 

This  CSU  is  like  in_object  but  includes  a  check  of  a  grid  locator  word.  This  CSU  returns  1 
if  the  point  (xo')  with  grid  locator  word  glword  is  within  the  North_South_east_West 
extent  of  the  <num_objects>  objects,  with  OBJECT_DESCRIPTIONS  beginning  at 
objectp..  It  returns  0  otherwise. 


I  Parameters  I 

Parameters 

Where  Tvpedef  Declared 

num  objects 

reoister  int 

Standard 

*objectp 

pointer  to  register 

OBJECT  DESCRIPTOR 

terrain.h 

X 

reoister  double 

Standard 

y 

register  double 

Standard 

Qlword 

HWORD 

mass  stdc.h 

I  ReturnValues  I 

Return  Value 

Type 

Meanina 

1 

int 

Point  (x,y)  withgrid  locator 
word  within  extent  of 
<num  oblects>  objects. 

0 

int 

Not  within. 

1  Calls  1 

Function 

Where  Described 

GET  OBJECT  MAX  X 

terrain.h 

GET  OBJECT  MIN  X 

terrain.h 

GET  OBJECT  MAX  Y 

terrain.h 

GET  OBJECT  MIN  Y 

terrain.h 

Table  2.6-367;  in_object2  CSU  [8.6.7.2.2] 
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2. 6. 7. 3  pve.h  CSU 
/simnet/libsrc/libpvis/pve.h 

This  CSU  contains  constant,defines,  macro  expansions  (defined  in  Appendix  A)  and  three 
structure  definitions. 

The  constant  defines  are  contained  in  the  following  tables. 

If  TRUE  is  not  defined,  the  following  values  are  assigned  TRUE  and  FALSE. 


Constant 

Value 

TRUE 

1 

FALSE 

0 

Table  2.6-368:  TRUE  and  FALSE  Constant  Definitions 


Constant 

Value 

EPSI 

0.001 

TWO  EPSI 

0.002 

EPSI  EPSI 

0.000001 

EPSILON 

I.0e-10 

THRESHOLD 

1.0 

PV  BIG  RATIO 

1e+15 

PV  SMALL  RATIO 

-1e+15 

PV  SMALL  TREE  RATIO 

-1e+20 

PATCH  SIDE 

500 

TREE  MAX  2 

15.0 

DEFAULT  TREELINE  WIDTH 

1.5 

ACCURATE  DIFFRAC  RANGE 

1000 

Table  2.6-369:  pve.h  Size  Constant  Definitions 


Constant 

Value 

TERMINATE 

16 

RES  OFLOW 

6 

PV  GRID  NUM 

4 

REFINEMENT  LEVEL 

2 

OBJECT  VERTS 

4 

BVOL  VERTS 

4 

Table  2.6-370:  pve.h  Constant  Definitions 


Constant 

Value  1 

FULL  TREE  MASK 

3 

t  set  4  and  8  bits  too  V 

PART  TREE  MASK 

7 

r  setBbittoO  */ 

PART  SOLID  MASK 

13 

/*  set  2  bit  to  0  */ 

INVIS  MASK 

0 

r  set  all  bits  to  0  */ 

Table  2.6-371:  Visibility  Mask  Values  Constant  Definitions 
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Constant 

Value 

T  LINE  BOT  WINDOW 

1 

MIN  TREELINE  HEIGHT 

T  LINE  BOT  WINDOW 

TREE  TOP  CUTOFF 

2 

Table  2.6-372:  Tree  and  Treeline  Height  Constant  DeHnitions 


Constant 

Value 

FIR  TREE 

OxfOfO 

SMALL  TREE 

OxfIfO 

LARGE  TREE 

0xf2f0 

TALL  BUSH 

0x1310 

SHORT  BUSH 

0x1410 

SOLDIER 

OxfSfO 

ROCK 

0x1610 

GRAVESTONE 

0xf7f0 

JEEP 

0xf2f1 

TENT 

0x1311 

MOBILE  HOME 

0x1411 

ONE  STORY  BARRACKS 

OxfSfl 

HOUSE 

0xf6f1 

SMALL  HOUSE 

0x1711 

OFFICE  BUILDING 

0x1811 

GUARD  TOWER 

0x1911 

WATER  TOWER 

Oxibll 

TWO  STORY  BARRACKS 

Oxlell 

TELEPHONE 

Oxllcl 

POWER  TOWER 

Oxlldl 

CHURCH 

6x1111 

Table  2.6-373:  Obstacles  Constant  Definitions 


Constant 

Value  1 

PVE  LEFT 

PVE  TOP 

1 

PVE  RIGHT 

2 

PVE  BOTTOM 

3 

Table  2.6-374:  PVE_  Edges  Constant  Definitions 

Constant 

Value 

PVE  GLW  LEFT 

13 

PVE  GLW  TOP 

31 

PVE  GLW  RIGHT 

28 

PVE  GLW  BOTTOM 

PVE  CLV  ERROR 

Table  2.6-375:  PVE_GLW_  Edges  Constant  Definitions 
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The  following  constants  define  various  edge  types  used  in  calls  to  CSU  check_edges.  Sec. 
2.6.7. 1.8. 


Constant 

Value 

TERRAIN 

0 

OBJECT  IN 

1 

OBJECT  OUT 

2 

TREE 

3 

TREELINE 

4 

TOTAL  BLOCK  CANOPY 

5 

PART  VIS  CANOPY 

6 

Table  2.6*376:  Edge  Type  Constant  Definitions 
The  first  of  the  three  typedef  structures  is  tagged  point. 


Item 

Type 

Where  Type  Defined 

X  taro 

int 

Standard 

V  tara 

int 

Standard 

seen 

int 

Standard 

X  hit 

int 

Standard 

V  hit 

int 

Standard 

Table  2.6*377:  point  tagged  Structure  Definition 


The  following  typedef  street  is  tagged  pvis_vertex. 


Item 

Where  Type  Defined 

X 

double 

Standard 

y 

double 

Standard 

z 

double 

Standard 

dist 

double 

Standard 

Table  2.6*378:  PV_VERTEX  Structure  Definition 
The  following  typedef  struct  is  tagged  str. 


Item 

Where  Type  Defined 

minx :  2 

HWORD 

mass  stdc.h 

HWORD 

mass  stdc.h 

1  minz  :  2  I 

HWORD 

mass  stdc.h 

HWORD 

mass  stdc.h 

maxy  :2 

HWORD 

mass  stdc.h 

maxz  ;2 

HWORD 

mass  stdc.h 

waste  :  4  /*  unused  bits  V 

HWORD 

mass  stdc.h 

Table  2.6-379:  PVIS_STR  Structure  Definition 
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2. 6. 7. 4  pvis_call.h  CSU 

/simnet/libsr(Vlibpvis/pvis_call.h 


This  CSU  contains  a  number  of  constant  defines  including  the  testing  and  debugging 
previously  mentioned  and  contained  in  the  following  table. 


Constant 

Value 

COUNT  HITS 

0  /*  Doni  collect  stats  on  number  of  hits  found  */ 

CHECK  DIFFRAC 

0  r  Doni  check  diffraction  approximation  accuracy  *! 

Table  2.6*380:  pvis_call.h  Test  and  Debug  Constant  Definitions 


The  remaining  constant  defines  can  be  broken  down  into  three  groups.  The  first  of  these 
groups  specifies  the  functionality  of  CSU  pve_checkvis.  The  ccaistants  can  be  logically 
ORed  to  provide  the  value  of  the  vis_test  field  in  the  PV_PARMS  structure. 


Constant 

Value 

PV  SEGMENTS 

1 

PV  PT  TO  PT 

2 

PV  DIFFRACTION 

4 

PV  CLUTTER 

8 

PV  OBSTACLES 

16 

PV  AIR  OBSTACLES 

(1«5) 

PV  PATCH  HEIGHT 

(1«6) 

PV  PATCH  GUARDS  ONLY 

(1«7) 

PV  MAX  GROUND  ELEV 

(1«8) 

Table  2.6-381:  vis_test  Constant  Definitions  For  The  PV_PARMS 

Structure 


The  second  group  of  constants  is  the  visibilty  code  values  that  CSU  pve_checkvis  uses.  If 
a  visibility  check  is  not  made,  pve_checkvis  returns  DUMMY,  8,  which  is  a  constant 
defined  in  the  third,  miscellaneous,  constant  definition  table. 


1  Constant 

Value 

1  FULLY  VISIBLE 

15 

PT  BLK  SOLID 

13 

IpT  BLK  TREES 

7 

PT  BLK  SOLID  PT  BLK  TREES 

5 

FULL  BLK  TREES 

3 

PT  BLK  SOLID  FULL  BLK  TREES 

1 

1  INVISIBLE 

0 

Table  2.6*382:  pve_checkvis  Constant  Definition  Returns 
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Constant 

Value 

NOTALOS 

13 

CLUTTER 

10 

DUMMY  r  Dv  checkvis  return  if  no  checks  V 

8 

BLOCKED 

-1 

PV  MAX  HITS  PER  PATCH 

100 

PV  MAX  TREE  BLOCKS 

4 

Table  2.6*383:  pvis_call.h  Miscellaneous  Constant  Definitions 


This  header  file  contains  three  structures.  The  first  structure,  named  PV_CHANGE_PT,  is 
contained  in  the  following  table. 


Item 

Type 

Where  Type  Defined 

vis 

int 

Standard 

X 

double 

Standard 

V 

double 

Standard 

Table  2.6*384:  PV_CHANGE_PT  Structure  Definition 

The  element  vis  gives  the  visibility  on  the  segment  between  this  PV_CHANGE_PT  and  the 
previous  one;  the  other  elements  are  the  coordinates  of  the  point 


The  second  structure,  PV_Hrr_PT,  is  tagged  hit_point  and  describes  a  hit  point  in  an  array 
of  forwardly  linked  hit  points. 


litem 

Where  Type  Defined 

int 

Standard 

X 

double 

Standard 

V 

double 

Standard 

z  top 

double 

Standard 

z_bot  in 

double 

Standard 

z  bot  out 

double 

Standard 

dist 

double 

Standard 

ratio 

double 

Standard 

*nextp 

pointer  to  struct  hit  point 

This  typedef  struct 

Table  2.6*385:  PV  HIT  PT  Structure  Definition 


The  "z_"  in  the  above  structure  are  relative  to  z_from  (ie.  z_from  set  as  zero),  and  the 
z_bot_in  and  z_bot_out  are  valid  only  for  trees  and  objects.  For  objects,  the  "ratio"  is  at 
the  top  of  the  object. 

Both  of  the  above  structures  are  contained  in  the  final  structure  definition,  PV_P ARAMS, 
which  contains  all  the  parameters  for  checking  visibility  in  pve.checkvis. 
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Item 


vis  tests  r  ORed  vis  tests  V 


r  eve  Dt  coords  / 


r  taroet  coords  / 


uardp  r  terrain  db  patch  V 


obstacle  hit 


obstacle  min 


obstacle  max 


max  chanae  Pts 


max  hit  Pts 


hit  ptst 


num  chanae  pts 


info 


block 


clutter 


num  trees 


treeslPV  MAX  TREE  BLOCKS 


canopy  hit 


delta  dist 


num  patch  pts 


atch  heiaht  pts 


max  elev  pt 


#if  CHECK  DIFFRAC 


exact  dih  ranqe 


exact  dst 


#endif 


#if  COUNT  HITS 


tot  terr  edaes 


terr  edae  checks 


terr  mid  hits 


terr  vtx1  hits 


terr  vtx2  hits 


tot  can  edaes 


can  edae  checks 


can  md  tuts 


can  vtxl  hits 


can  vtx2  hits 


#endif 


int 


double 


double 


inter  to  PATCH  GUARD 


double 


mt 


TDB  POINT 


TDB  POINT 


int 


inter  to  PV  CHANGE  PT 


mt 


inter  to  PV  HIT  PT 


int 


int 


TDB  POINT 


TDB  POINT 


mt 


TDB  POINT 


int 


double 


int 


inter  to  TDB  POINT 


TDB  POINT 


int 


double 


Where  Type  Defined 


Standard 


Standard 


Standard 


terrain.h 


Standard 


Standard 


tdb.h 


tdb.h 


Standard 


Sec.  2.6.7.4 


Standard 


Sec.  2.6.7.4 


Standard 


Standard 


tdb.h 


tdb.h 


Standard 


tdb.h 


Standard 


Standard 


Standard 


tdb.h 


tdb.h 


Standard 


Standard 


int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 

int 

Standard 
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2.6.8  libdatabase  CSC 
/simnet/libsrc/libdatabase 

This  library  handles  the  loading  of  and  the  querys  to  the  parameter  files. 


libdatabasa 

CSC 


Figure  2.6-26:  libdatabase  CSC  Structure 


2.6.8. 1  interpolate.c  CSC 

/simnet/libsrc/libdatabaseAnterpolate.c 

This  CSC  contains  the  curve  interpolation  CSU  inteipolate_curve. 


interpolate.c 

CSC 

8.6.8.1 


Cinterpolate^curve  A 
CSU8.6.8.1.1  J 

Figure  2.6-27:  interpolate.c  CSC  Structure 


2.6.8. 1.1  interpolate_curve  CSU 


Parameters 


curve 


in  X 


Parameters 


e 


inter  to  DATA  UNION 


REAL 


Where  Tvoedef  Declared 


Sec.  2.1. 1.5 


sim  t 
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1  ReturnVaiues  1 

1  Return  Value 

Tvoe 

Meaning 

REAL 

No  points. 

(curve[1  ].array)[2].real 

REAL 

(num_points=*1)  || 

(in  x<-(curveril.array)f1l.!eal) 

(curve[num_pointsl.array)[2].r 

eal 

REAL 

v1  +((in  x-x1  )*(v2-v1 )  /  (x2-x1 )) 

REAL 

H _ 

REAL 

None  of  the  above  occurs.  1 

Table  2.6>362:  interpolate_curve  CSU  [8.6.8.1.1] 


2. 6. 8. 2  detection.c  CSC 

/simnet/libsrc/libdatabase/detection.c 

This  CSC  contains  detection  database  functions. 


(show  detection  database 
CSU  8.6.8~2.1 

Figure  2.6>28:  detection.c  CSC  Structure 


2. 6. 8. 2.1  show_detection_database  CSU 

This  CSU  displays  primaiy  and  secondary  curves. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show  curves 

Sec.  2.6.8.8.3 

Table  2.6-363: 

show_detection_database  CSU  [8.6.8.2.1] 

c 


database  detection  query 
CSU  8.6.8.2.2~ 


9 
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2. 6. 8. 2. 2  database_detection_query  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

det  db 

DATA  UNION 

Sec.  2.1. 1.5 

view  type 

int 

Standard 

pri  sec 

int 

Standard 

REAL 

Sim  tvpes.h 

■  view 

int 

Standard 

1  ReturnValues  1 

1  Return  Value  1 

Meaning 

REAL 

Normal  end. 

1  Calls  1 

Function 

Where  Described 

interpolate_curve 

Sec.  2.6.8. 1.1 

Table  2.6-364:  database_detection_query  CSV  [8.6.8.2.2] 

2.6. 8.3  hitmodel.c  CSC 

/simnet/libsrc/libdatabase/hitmodel.c 

This  CSC  contains  the  hitmodel  database  CSU. 


show_hitniodGl_database 
CSU  8.6.8.3.1 


Figure  2.6-29:  hitmodel.c  CSC  Structure 


2. 6. 8. 3.1  show_hitmodel_database  CSV 


This  CSU  displays  hitmodel  curves. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

Calls 

Function 

Where  Described 

show  curves 

Sec.  2.6  8.8.3 

Table  2.6-365:  show_hitmodel_database  CSU  [8.6.8.3.1] 
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2. 6. 8. 4  formation.c  CSC 

/simnet/libsrc/libdatabase/formadon.c 

This  CSC  contains  formation  database  CSUs. 


database 

CSU 


►_read_formation  ^  ^ database_formation_torm_'N  ^ 
U8.6.8.4.1  J  ^  query  CSU8.6.8.4.2  J  V 


database_fonnation_ 
form  query  CSU  8.( 


Figure  2.6-30:  formation.c  CSC  Structure 


2. 6. 8. 4.1  database_read_formation  CSU 

This  CSU  attempts  to  read  a  database  file  and  displays  a  message  if  unable  to. 


1  Parameters  1 

Parameters 

Where  Tvoedef  Declared 

tactics 

int 

Standard 

*name 

pointer  to  char 

Standard 

1  Calls  1 

Function 

Where  Described 

reader  read  file 

Sec.  2.1. 1.1 .7 

Table  2.6-366:  database  read  formation  CSU  [8.6.8.4.1] 


2. 6. 8. 4. 2  database_formation_form_query  CSU 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

tactics 

int 

Standard 

•echelon 

pointer  to  char 

Standard 

•formation 

pointer  to  char 

Standard 

•job 

pointer  to  char 

Standard 

1  ReturnValues  1 

■  Return  Value 

Type 

Meaning 

'■III  IIIHW— 1 

pointer  to  DATA  UNION 

Normal  end. 

1  Calls  1 

Function 

Where  Described 

find  tag 

Sec.  2.1. 1.4.3 

oet.symbol 

Sec.  2.1 .1.3.2 

Table  2.6-367: 


database_formation_form_query  CSU  [8.6.8.4.2] 
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2. 6. 8. 4. 3  database_formation_sub_forin_query  CSU 


\  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

tactics 

int 

Standard 

'echelon 

pointer  to  char 

Standard 

'formation 

pointer  to  char 

Standard 

'job 

pointer  to  char 

Standard 

1  ReturnVaiues  1 

Return  Value 

Type 

Meanina 

dbr2I.array 

pointer  to  DATA  UNION 

Normal  end. 

1  Calls  1 

Function 

Where  Described 

find  taa 

Sec.  2.1.1 .4.3 

aet  symbol 

Sec.  2. 1.1 .3.2 

Sec.  2.6.8.4.2 

Table  2.6>368:  database_formation_sub_form_query  CSU  [8.6.8.4.3] 


2. 6. 8. 5  echelon.c  CSC 

/simnet/libsrc/Iilxiatabase/echelon.c 

This  CSC  contains  echelon  database  CSUs. 


database_read_echelon 

CSU  8  6.8.5.1 


databasa_echelonjtemplate 

query  CSU  8.6.8.5.2 


database. 

query  CSU 


i_echelon_lobL 
;SU  8.6.8.S.3  J 


/^atabas 

Lj 


1 


^database_echelqn_response 
_fermatien_query 
CSU  8.6.8.5.4 


5 


Figure  2.6>31:  echelon.c  CSC  Structure 
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2. 6. 8. 5.1  database  read  echelon  CSU 


This  CSU  attempts  to  read  a  database  file  and  displays  a  message  if  unable. 


1  Parameters  1 

Parameters 

Tvne 

Where  Tvoedef  Declared 

tactics 

int 

Standard 

*name 

Dointer  to  char 

Standard 

Calls 

Function 

Where  Described 

reader  read  file 

Sec.  2.1. 1.1.7 

Table  2.6-369:  database  read  echelon  CSU  [8.6.8.5.1] 


2. 6. 8. 5. 2  database_echelon_template_query  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

tactics 

int 

Standard 

va  alist 

Standard 

1  ReturnValues  1 

Return  Value 

Meanina 

0 

pointer  to  DATA_UNION 

Keyword  or  template  not 
found. 

hold 

pointer  to  DATA  UNION 

Normal  end. 

1  Calls  1 

Function 

Where  Described 

qet  symbol 

Sec.  2.1. 1.3.2 

find  taq 

Sec.  2.1. 1.4.3 

Table  2.6-370:  database_echelon_teniplate_query  CSU  [8.6.8.5.2] 


2. 6. 8. 5. 3  database_echelon_lobj_query  CSU 
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1  Calls  1 

Function 

Where  Described 

database_echelon_template_ 

query 

Sec.  2.6.8.5.2 

Table  2.6-37 1:  database_echelon_lobj_query  CSU  [8.6.8.S.3] 


2. 6. 8. 5. 4  database_echelon_response_forination_query  CSU 


Parameters 


tactics 


echelon 


context 


Return  value 


result 


hold 


Parameters 


inter  to  char 


inter  to  char 


Where  Tvpedef  Declared 


Standard 


Standard 


Standard 


ReturnVaiues 


inter  to  DATA  UNION 


pointer  to  DATA_UNION 


Meanin 


Formation  is  context  sensitive. 


Formation  is  not  context 
sensitive. 


Calls 


Function  Where  Described 


database_echelonjemplate_  Sec.  2.6.8.5.2 
uerv 


lind  tao  I  Sec.  2.1 .1.4.3 


et  symbol  Sec.  2.1 .1 .3.2 


Table  2.6-372: 


database  echelon  response  forniation_query  CSU 
■  [8.6.875.4] 
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2. 6. 8. 6  df_damage.c  CSC 

/simnet/libsrc/libdatabase/df.damage.c 


This  CSC  ccHitains  the  direct  fire  database  CSUs  and  constants  that  define  vehicle  walls. 


Figure  2.6-32:  df_damage.c  CSC  Structure 


The  constant  definitions  for  this  CSC  are  in  the  following  table. 


Constant 

Value 

VEHICLE  WALL  FRONT 

1 

VEHICLE  WALL  BACK 

2 

VEHICLE  WALL  LEFT 

3 

VEHICLE  WALL  RIGHT 

4 

VEHICLE  WALL  TOP 

5 

Table  2.6-373:  df_damage.c  Constant  Definitions 


2. 6. 8. 6.1  show_df_daniage_database  CSU 

This  CSU  displays  information  from  the  direct  fire  damage  database. 


c 

Parameters 

Parameters 

Type 

Where  Typedef  Declared 

df  damaae 

DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show  df  damaae  veh 

Sec.  2.6.8  6.2 

find  taa 

Sec.  2.1 .1.4.3 

aet  symbol 

Sec.  2.1 .1.3.2 

Table  2.6-374:  show_df_damage_database  CSU  [8.6.8.6.1] 
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2. 6. 8. 6. 2  show_df_damage_veh  CSU 


I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2. 1.1. 5 

Calls 

Function 

Where  Described 

show  df  damage  weapon 

Sec.  2.6.8.6.3 

find  tag 

Sec.  2.1. 1.4.3 

get  symbol 

Sec.  2.1 .1.3.2 

Table  2.6-375: 

show_df_damage_veh 

CSU  [8.6.8.6.21 

2. 6. 8. 6. 3  show_df_damage_weapon  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show  df  .damage  object 

Sec.  2.6.8.6.4 

Table  2.6-376:  show_df_damage_weapon  CSU  [8.6.8.6.3] 


2. 6. 8. 6. 4  show_df_damage_object  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2. 1.1.5 

Calls 

Function 

Where  Described 

show  df  damage  side 

Sec.  2.6  8.6.5 

find  tag 

Sec.  2. 1.1. 4.3 

get  symbol 

Sec.  2.1 .1.3.2 

Table  2.6-377:  show_df_daniage_object  CSU  [8.6.8.6.4] 


2. 6. 8. 6. 5  show_df_damage_side  CSU 

_  Parameters _ _ 

Parameters  Type  Where  Typedef  Declared 

*db _ pointer  to  DATA  UNION _ Sec.  2.1.1 .5 _ 


384 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


1  Calls  1 

Function 

Where  Described 

show  df  damaae  entry 

Sec.  2.6.8.6.6 

Table  2.6-378: 

show_df_damage_side 

CSU  [8.6.8.6.51 

2. 6. 8. 6. 6  show_df_damage_entry  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1.1 .5 

Table  2.6-379:  show_df_damage_entry  CSU  [8.6.8.6.6] 


2. 6. 8. 6. 7  vehicle_wall_name  CSU 

This  CSU  converts  the  value  for  a  vehicle  wall  name  to  a  character  string. 


i  Parameters  I 

Parameters 

Where  Tvpedef  Declared 

side 

int 

Standard 

I  ReturnValues  I 

Return  Value 

Type 

Meanina 

"front' 

pointer  to  char 

VEHICLE  WALL  FRONT 

pointer  to  char 

VEHICLE  WALL  BACK 

pointer  to  char 

VEHICLE  WALL  LEFT 

-rioht" 

pointer  to  char 

VEHICLE  WALL  RIGHT 

"top" 

pointer  to  char 

VEHICLE  WALL  TOP 

"unknown" 

pointer  to  char 

Name  unknown. 

Table  2.6-380:  vehicle_wall_name  CSU  [8.6.8.6.7] 


2. 6. 8. 6. 8  vehicle_component_name  CSU 

This  CSU  converts  the  value  for  a  vehicle  component  name  to  a  character  string. 


I  Parameters  I 

Parameters 

Type 

Where  Tvpedef  Declared 

component 

VehicleComponent 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

"hull" 

pointer  to  char 

hullComponent 

"turret" 

pointer  to  char 

turretComponent 

"unknown" 

pointer  to  char 

Component  unknown. 

Table  2.6-381:  vehicle_component_name  CSU  [8.6.8.6.8] 
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2. 6. 8. 6. 9  sort_damage_table  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

•db 

pointer  to  DATA UNION 

Sec.  2. 1.1. 5 

Calls 

Function 

Where  Described 

sort  taa  te^le 

Sec.  2.1 .1.4.5 

Table  2.6*382:  sort_dainage_table  CSU  [8.6.8.6.9] 


2.6.8.6.10  database_df_damage_query  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1.1 .5 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

random  number 

int 

Standard 

ammo 

ObiectType 

p  sim.h 

fireresult 

FireResult 

p  sim.h 

component 

VehicleComponent 

basic.h 

pointer  to  float 

Standard 

•traiectorv 

pointer  to  float 

Standard 

*dimensions 

REAL 

Sim  tvpes.h 

debuQ  flao 

int 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

NO_DAMAGE 

int 

Unknown  munition,  unknown 
component,  unknown  angle, 
proximity  fuze  outside  range, 
no  catastrophic  damage,  no 
mobility  damage,  or  no 
firepower  damage. 

1  Calls  1 

Function 

Where  Described 

find  taa  sorted 

Sec.  2.1. 1.4.7 

compute  damaae  keys 

Sec.  2.6.8.6.11 

vehicie  component  name 

Sec.  2.6.8.6.8 

vehicle  wall  name 

Sec.  2.6.8.6  7 

show  df  damaae  entry 

Sec.  2.6.8.6.6 

vec  maa3 

Sim  macros.h 

Table  2.6-383:  database_df_damage_query  CSU  [8.6.8.6.10] 
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2.6.8.6.11  compute_damage_keys  CSU 


Prior  to  this  CSU,  two  constants  are  defined  (#dcfine  TAN30  0.57735;  #define  TAN60 
1.73205)  and  a  static  side_lookup_table  is  declared  and  initialized. 


1  Parametara  1 

1  Parameters  1 

Typo 

Where  Typedef  Declared 

pointer  to  float 

Standard 

•traieclorv 

pointer  to  float 

Standard 

^dimensions 

pointer  to  REAL 

Sim  tvpes.h 

‘side 

pointer  to  int 

Standard 

‘anale 

pointer  to  int 

Standard 

1  Calls  1 

Function 

Where  Described 

fvec  to  rvec 

Sec.  2.14.3.5.13 

which  side 

Sec.  2.14.3.5.9 

Table  2.6-384:  compute_dainage_keys  CSU  [8.6.8.6.11] 


2. 6. 8. 7  if_damage.c  CSC 

/simnet/libsrcAibdatabaseAf_damage.c 

This  CSC  contains  the  indirect  fire  database  CSUs. 


Figure  2.6-33:  if_damage.c  CSC  Structure 
2. 6. 8. 7.1  show_if_damage_database  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

if  damage 

DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show  if  damage  veh 

Sec.  2.6.8  7.2 

Table  2.6-385:  showjf_damage_database  CSU  [8.6.8.7.1] 
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2. 6. 8. 7. 2  show_if_damage_veh  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show__if_  damage,  weapon 

Sec.  2.6.8.7.3 

Table  2.6>386:  show_if_dainage_veh  CSU  [8.6.8.7.2] 


2. 6. 8. 7. 3  show_if_damage_weapon  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

showJf_ranged_damage_ 

entry 

Sec.  2.6.8.7.4 

Table  2.6-387:  showJf_damage_weapon  CSU  [8.6.8.7.3] 


2. 6. 8. 7. 4  show_if_ranged_damage_entry  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

1  Calls  1 

Function 

Where  Described 

show  if  damage  entry 

Sec.  2.6.8.7.5 

Table  2.6-388:  show_if_ranged_damage_entry  CSU  [8.6.8.7.4] 


2. 6. 8. 7. 5  show_if_damage_entry  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*db 

pointer  to  DATA  UNION 

Sec.  2.1 .1.5 

Table  2.6-389:  showJf_damage_eiitry  CSU  [8.6.8.7.5] 
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2. 6. 8. 7. 6  database_if_damage_query  CSU 


Parameters 


*db 


rand 


ammo 


fuze 


f2 


debua  fla 


Parameters 


intertoDATA  UNION 


intertoDATA  UNION 


int 


ObiectTvpe 


ObiectTvoe 


REAL 


int 


l|7 

11? 


Where  Typedef  Declared 


Sec.  2. 1.1. 5 


Sec.  2.1 .1.5 


Standard 


sim.h 


sim.h 


Sim  t 


Standard 


ReturnVaiues 


Return  Value 


NO  DAMAGE 


CATASTROPHIC_DAMAGE  int 


MOBILITY  DAMAGE 


FIREPOWER  DAMAGE 


Meanin 


Unknown  fuze,  unknown 
ammunition,  w  table  overrun, 
or  none  of  the  damaae  betow. 


Catastrophic  damage  selected 
randomly. 


Firepower  damage  selected 
randomly. 


Function 


find  taa  sorted 


find  ta 


show  if  damaae  ent 


Calls 


Where  Described 


Sec.  2.1 .1.4.7 


Sec.  2.1. 1.4.3 


Sec.  2.6.8.7.5 


Table  2.6-390:  database_if_dainage_query  CSU  [8.6.8.7.6] 

2. 6. 8. 8  database.c  CSC 

/simnet/libsrp/libdatabase/database.c 

This  CSC  contains  the  common  database  utility  CSUs. 


database.c 

CSC 

8.6.8.8 


database_read 
CSU  8.6.88. 1 


show  table_record 
CSU  8.6.8.8.2 


show_curves 
CSU  8.6.8.8.3 


Figure  2.6-34:  database.c  CSC  Structure 
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2. 6. 8. 8.1  database_read  CSU 


This  CSU  attempts  to  read  a  database  file  and  displays  a  message  if  unable. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*db 

Dointerto  DATA  UNION 

Sec.  2.1. 1.5 

*name 

pointer  to  char 

Standard 

Calls 

Function 

Where  Described 

reader  read  file 

Sec.  2.1. 1.1. 7 

Table  2.6*391:  database_read  CSU  [8.6.8.8.1] 


2. 6. 8. 8. 2  show_table_ 

record  CSU 

1  Parameters  1 

Parameters 

Tvoe 

Where  Tvpedef  Declared 

*table 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Table  2.6-392:  show_table_record  CSU  [8.6.8.8.2] 


2. 6. 8. 8. 3  show_curves  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘curves 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

Calls 

Function 

Where  Described 

show  table  record 

Sec.  2.6.8.8.2 

Table  2.6-393:  show  curves  CSU  [8.6.8.8.3] 


2. 6. 8. 9  libdatabase.h  CSU 

/simnet/libsic/libdatabase/libdatabase.h 

This  CSU  contains  constants,  macros,  and  external  function  definitions.  The  macro 
data_base_hitmodel_query  is  shown  in  Appendix  A  and  the  constants  are  shown  in  the 
following  table. 
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Constant 

Value 

VIEW  BLCX5KED 

-1 

STATIONARY 

MOVING 

1 

HULL  DOWN 

2 

PRIMARY  ARC 

0  r  Detection  oarameters  V 

SECONDARY  ARC 

1 

GROUND  VIEW 

AIR  VIEW 

1 

TACTICS  NATO 

1  r  Tactics*/ 

TACTICS  WARSAW 

2 

NO  DAMAGE 

MOBILITY  DAMAGE 

1 

FIREPOWER  DAMAGE 

2 

CATASTROPHIC  DAMAGE 

3 

ARTY  TYPE  GROUND 

1  /*  Artillary  types  */ 

ARTY  TYPE  VEHICLE 

2 

ARTY  TYPE  DEATH 

3 

Table  2.6-394:  libdatabase.h  Constant  Definitions 


I 


I 
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2.6.9  Weapons  CSC 


The  weq)ons  code  is  called  by  the  local  vehicles  while  executing  their  ticks.  This  code 
simulates  the  target  selection,  weapons  selection,  target  tracking,  and  firing  of  the  missiles. 
It  also  determines  if  the  weapon  hit  its  target 


Figure  2.6-35:  Weapons  CSC  Structure 


2. 6. 9.1  missile.c  CSC 

/simnet/src/host/missile.c 


This  CSC  handles  missiles,  including  creation,  deletion,  flying  the  missile,  impact,  and 
hit/miss  computation. 


r  hull_to_wor1d_from_ 
v  direction  CSU  8.6.9.1 .1 

DC 

missile  state  to  suing 
CSU  8.6.9.1.2 

'N  (  create  missile  A 

)  K  CSU8.6.9.1.3  J 

■  1 

”■  1 

1 

r  destroy  missile 

V  CSU8.6.9.1.4 

DC 

missile  show 

CSU  8.6.9.1.5 

^  r  fire  missile  at  target  ^ 

J  V  CSU8.6.9.1.6  J 

1 

j: 

1 

r  missile_ground  impact 

f  compute  explosion_point'N 

J  \  CSU8.6.9.1.9  / 

V  CSU8.6.9.1.7 

■ _ __U _ 

1 

1 

r  mi8sile_mayt>e_hit_target  'N 

fly  missile 

A  ^missile  set  desired  directioTV 

J  CSU  8.6.9.1.12  J 

V  CSU  8.6.9.1.10 

J 

CSU  8.6.9.1.11 

c 


missils_s6nd 
CSU  8.6 


lappearance^ 

5.9.1.13  J 

Figure  2.6-36;  missile.c  CSC  Structure 
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2. 6. 9. 1.1  hull  to  world  from  direction  CSU 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

direction 

VECTOR 

sim  types.h 

h2w 

T  MATRIX 

Sim  types.h 

Table  2.6-395;  huII_to_world_from_direction  CSU  [8.6.9.1.1] 


2.6.9. 1.2  missile_state_to_string  CSU 


This  CSU  converts  a  missile  state  variable  to  a  character  string. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

state 

int 

Standard 

1  ReturnValues  I 

Return  Value 

Meaning 

"idle* 

pointer  to  char 

case  MISSILE  STATE  IDLE 

"tracking" 

pointer  to  char 

CdSG 

MISSILE  STATE  TRACKING 

"armed" 

pointer  to  char 

C3SG 

MISSILE  STATE  ARMED 

"lost  target* 

pointer  to  char 

case 

MISSILE  STATE  TARGET 
LOST 

"crashing" 

pointer  to  char 

cdsc 

MISSILE  STATE  CRASHING 

"unknown" 

pointer  to  char 

Unknown  case. 

Table  2.6-396: 

missile_state_to_string 

CSU  [8.6.9.1.2] 

2.6.9. 1.3  create_missile  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

"table 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

ownerlD 

unsigned  short 

Standard 

forcefO 

ForcelD 

basic.h 

ReturnValues 

Return  Value 

Meaning 

missile 

pointer  to  MISSILE  VARS 

Created  missile. 
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1  Calls  1 

Function 

Where  Described 

allocate  missile 

Sec.  2.6.9.2  See  Aopendix  A 

oenerate  vehicle  id 

aet  Quises 

Sec.  2.6.1 .1.8 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDO 

ft  float 

Sec.  2.14.1.2.12 

dea  to  rad 

Sim  macros.h 

PrepareDiscrepancyThreshol 

ds 

buffer  allocate 

Sec.  2.14.4.2.12 

Table  2.6>397:  create  missile  CSU  [8.6.9.1.3] 


2. 6. 9. 1.4  destroy _missile  CSU 

This  CSU  deallocates  previously  allocated  missile  memory  space. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘missile 

DOinter  to  MISSILE  VARS 

Sec.  2.6.9.2 

Calls 

Function 

Where  Described 

buffer  deallocate 

Sec.  2.14.4.2.15 

deallocate  missile 

Sec.  2.6.9.2  See  Appendix  A 

Table  2.6>398:  destroy_missile  CSU  [8.6.9.1.4] 


2. 6. 9. 1.5  missile_show  CSU 

This  CSU  displays  descriptive  information  for  a  missile  in  flight. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘missile 

pointer  to  MISSILE  VARS 

Sec.  2.6.9.2 

1  Calls  j 

Function 

Where  Described 

simnet  id  strina  from  saf  id 

mps  to  kph 

i  i  i  ■  ■ 

rad  to  .  dea 

Sim  macros.h 

missile  state  to  strinq 

Sec.  2.6.9.1.2 

Table  2.6-399:  missile  show  CSU  [8.6.9. 1.5] 
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2.6.9. 1.6  fire_missile_at_target  CSU 


Parameters 


safobi 


Parameters 


inter  to  SAF  OBJECT 


inter  to  WEAPON  VARS 


unsioned  short 


inter  to  REAL 


inter  to  REAL 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.9.1. 2 


Standard 


sim  tvoes.h 


Sim  t 


Error  Name 


Internal  error:  Shot  a  missile 
that  wasn't  available" 


Errors 


Reason  for  Error 


missile->state  MISSILE  STATE  IDLE 


Function 


OBJ  POSITION 


muzzle_positionJn_world_ 

coordinates 


vec  CO 


vec  sub 


vec  maoS 


vec  scale 


vec  add 


OBJ  VELOCITY 


vec  normalize 


hull  to  world  from  direction 


saf  vehicle  next  event  id 


simnet  send  fire 


missile  send  appearance 


DEBUG  MISSILE 


Calls 


Where  Described 


Sec.  2.9.1. 1  See  Appendix  A 


Sec.  2.6.9.8.18 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


sim  macros.h 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 


endix  A 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Sec.  2.6.9.1.1 


Sec.  2.6.1.1.28 


Sec.  2.6.9.1.13 


Sec.  2.5.2.2  See  Appendix  A 


Table  2.6-400:  rire_missile_at_target  CSU  [8.6.9.1.6] 


2. 6. 9. 1.7  missile_ground_impact  CSU 


395 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


1  Calls  1 

Function 

Where  Described  1 

LOOKUP  POSITION 

1  1  II 1 

vec  sub 

Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 

vec  dot  prod 

Sec.  2.6.2.54.1  Vehicles  CSCI  SDD 

coords  within  database 

simnet  send  impact 

1 

MOMENTUM 

ENERGY 

DEBUG  MISSILE 

1 1  "in  ^^—1 

missile  deactivate 

Sec.  2.6.g.1.8  1 

Table  2.6-401: 

missile_ground_impact 

CSU  [8.6.9.1.7] 

2. 6. 9. 1.8  missile_deactivate  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*missile 

pointer  to  MISSILE  VARS 

Sec.  2.6.9.2 

1  Calls  1 

Function 

Where  Described 

simnet  send  deactivate 

vec  init 

Sec.  2.6.2.61.1  Vehicles  CSCI  SDD 

Table  2.6-402:  missile  deactivate  CSU  [8.6.9.1.8] 


2.6.9. 1.9  compute_explosion_point  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

‘point 

pointer  to  REAL 

Sim  types,  h 

*P1 

pointer  to  REAL 

sim  types. h 

‘P2 

pointer  to  REAL 

Sim  types.h 

‘result 

pointer  to  REAL 

Sim  types.h 

1  Calls  1 

Function 

Where  Described 

vec  sub 

Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 

vec  dot  prod 

Sec.  2.6.2.54.1  Vehicles  CSCI  SDD 

vec  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

vec  add 

Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 

Table  2.6-403:  compute_explosion_point  CSU  [8.6.9.1.9] 
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2.6.9.1.10  mlssile_maybe_hit_target  CSU 

This  CSU  calculates  the  explosion  point  of  a  missile  and  determines  if  it  hit  the  target.  It 
must  hit  within  5  meters  of  a  vehicle  to  call  it  a  vehicleimpatx.  Otherwise  it  is  just  a 
pioximateimpact  The  impact  threshold  is  defined  before  this  CSU  (#define 
IMPACT_THRESHOLD  5.0). 


Parameters 


sition 


E 


Parameters 


inter  to  WEAPON  VARS 


inter  to  MISSILE  VARS 


Where  Tyoedef  Declared 


Sec.  2.9.1 .2 


Sec.  2.6.9.2 


unsioned  short 

1  Standard 

REAL 

Sim 

type 

REAL 

Sim 

type 

REAL 

Sim 

tyM 

Return  Value 


FALSE 


TRUE 


ReturnValues 


Meanin 


Still  closinQ  on  tarqet. 


Normal  end. 


Calls 

Function 

Where  Described 

vec  dot  prod 

Sec.  2.6.2.54.1  Vehicles  CSCI  SDD 

compute  explosion  point 

Sec.  2.6  9.1. 9 

ranae  sauared 

Sec.  2.14.3.5.10 

DEBUG  MISSILE 

Sec.  2.5.2.2  See  Adp 

endix  A 

LOOKUP  POSITION 

endix  A 

vec  sub 

Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 

vec  normalize 

Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 

P 


et  i  and  t  from  normal 


LOOKUP_HULL_TO_ 

WORLD 


LOOKUP  TURRETAZIMUTH 


LOOKUP  VEHICLECLASS 


simnet  send  imoact 


MOMENTUM 


ENERGY 


missile  deactivate 


Sec.  2.6.4.5.2 


Sec.  2.9.1. 1  See  Appendix  A 


1 1.-!  j  JJtTg 


endix  A 


Sec.  2.9.1. 1  See  Appendix  A 


Sec.  2.6  9.1. 8 


ndix  A 


ndix  A 


Table  2.6-404:  missile_maybe_hit_target  CSU  [8.6.9.1.10] 


2.6.9.1.11  fly_missile  CSU 


This  CSU  performs  the  calculations  for  a  missile  flight.  It  updates  the  position  and  speed, 
checks  arming  status,  checks  to  see  if  it  hit  the  targeL  determines  if  a  new  direction  should 
be  taken,  checks  to  see  if  it  hit  the  ground,  and  keeps  track  of  fuel  consumption. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

targetID 

unsigned  short 

Standard 
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ReturnValues 


Return  Value 


RCXJND  DONE  FLYING 


ROUND  IN  FLIGHT 


Meanin 


Missile  is  in  idle  state  or  has  hit 
the  target  or  has  hit  the 
ground  or  is  in  an  unknown 
state. 


Missile  is  in  fiqht. 


Function 


vec  CO 


vec  scale 


vec  add 


min 


DEBUG  MISSILE 


saf  vehicle  est  oosition 


LOOKUP  SAFOBJ 


LOOKUP  VELOCITY 


vec  sub 


vec  normalize 


range  squared 


missile  maybe  hit  target 


intervis  can  see  ot  to  ot 


missile  set  desired  direction 


vec  maa3 


tdb  get  z 


missile  ground  impact 


hull  to  world  from  direction 


missile  send  appearance 


kf  K  .! .! 


Calls 


Where  Described 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 


Sec.  2.6.7.3  &  Sec.  2.13.3.5  See 


ndix  A 


Sec.  2.6.1.1.58 


endix  A 


endix  A 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Sec.  2.14.3.5.10 


Sec.  2.6.9.1.10 


Sec.  2.6.5.2.1 


Sec.  2.6.9.1.12 


sim-macros.h 


Sec.  2.21.7.16.2 


Sec.  2.6.9.1.7 


Sec.  2.6.9.1.1 


Sec.  2.6.9.1.13 


ndix  A 


Table  2.6-405:  ny_missile  CSU  [8.6.9.1.11] 


2.6.9.1.12  missile  set  desired  direction  CSU 


I  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*missile 

pointer  to  MISSILE  VARS 

Sec.  2.6.9.2 

pointer  to  REAL 

Standard 

1 ‘direction  tojarget 

pointer  to  REAL 

Standard 

1  Calls  1 

Function 

Where  Described 

square 

Sim  macros.h 

vec_  scale 

Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 

vec  dot  prod 

Sec.  2.6.2.54.1  Vehicles  CSCI  SDD 

vec  sub 

Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 

vec  normalize 

Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 

vec  add 

Sec.  2.6.2.57.1  Vehicles  CSCI  SDD 

Table  2.6-406:  missile  set  desired  direction  CSU  [8.6.9.1.12] 
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2.6.9.1.13  missile_send_appearance  CSU 


Table  2.6-407:  inissiie_send_appearance  CSU  [8.6.9.1.13] 


2. 6. 9. 2  missile.h  CSU 
/simnet/src/hostAnissile.h 


This  CSU  contains  the  symbolic  constants,  structure  definition,  and  macro  definitions 
(shown  in  Appendix  A)  used  by  the  missile  code. 


Constant 

Value  1 

MISSILE  STATE  IDLE 

MISSILE  STATE  TRACKING 

1 

MISSILE  STATE  ARMED 

2 

MISSILE  STATE  TARGET  LOST 

3 

MISSILE  STATE  CRASHING 

Table  2.6-408:  missile.h  Constant  Definitions 
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The  following  typedef  struct  is  tagged  missile.vars. 


item 

Type 

Where  Type  Defined 

state  r  Flyina  state  of  missile  */ 

int 

Standard 

unsigned  short 

Standard 

ownerlD  /*  fivina  missile  */ 

unsigned  short 

Standard 

vehicleClass 

VehicleClass 

basic.h 

int 

Standard 

Quises 

VehicleGuises 

basic.h 

markina 

VehicleMarking 

basic.h 

VehicleCaoabilities 

basic.h 

forcelD 

ForcelD 

basic.h 

model  base  adjustment 

REAL 

Sim  tvpes.h 

last  tick  time 

unsigned  int 

Standard 

direction  /*  Physical  */ 

VECTOR 

Sim  tvpes.h 

VECTOR 

Sim  tvpes.h 

velocity 

VECTOR 

Sim  tvpes.h 

old  position 

VECTOR 

Sim  tvpes.h 

hull  to  world 

T  MATRIX 

Sim  tvpes.h 

ranae  remainina 

REAL 

Sim  tvpes.h 

speed  mps 

REAL 

Sim  tvpes.h 

desired  direction  /*  Maneu-  V 

VECTOR 

Sim  tvpes.h 

desired  velocitv  Tver*/ 

VECTOR 

Sim  tvpes.h 

max  vehicle  range  r  Flying  */ 

REAL 

Sim  tvpes.h 

max  speed  mps  /*&*/ 

REAL 

Sim  tvpes.h 

acceleration  rtriggering*/ 

REAL 

Sim  tvpes.h 

max  turn  rps  TparametersV 

REAL 

Sim  tvpes.h 

tan  superelevation  angle 

REAL 

Sim  tvpes.h 

cos  max  angle  to  target 

REAL 

Sim  tvpes.h 

fuze  distance2 

REAL 

Sim  tvpes.h 

effective  distance2 

REAL 

Sim  tvpes.h 

dimensions  /*  Appearance  V 

VECTOR 

Sim  tvpes.h 

update  thresholds  r  packet  V 

DiscrepancyThresholds 

libapp.h 

*last  update  /*&  threshold  */ 

pointer  to  SimulationPDU 

p  sim.h 

time  at  last  update  /*  stuff  */ 

int 

Standard 

Table  2.6-409:  MISSILE  VARS  Structure  Definition 


2. 6. 9. 3  targeting.c  CSC 
/simnet/src/host/targeting.c 

This  file  contains  the  code  which  handles  the  tracking,  prioritizing,  and  selection  of  targets. 
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Figure  2.6-37:  targeting.c  CSC  Structure 


2. 6. 9. 3.1  map_,roIe_syiii_to_role_nuinber  CSU 


This  CSU  converts  a  character  role  symbol  to  an  integer  role  number. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•svm 

pointer  to  char 

Standard 

ReturnValues 

Return  Value 

Type 

Meanina 

ATTACK  ROLE  ALL 

int 

ALL  SYM 

ATTACK  ROLE  NONE 

int 

NONE  SYM 

ATTACK  ROLE  GROUND 

int 

GROUND  SYM 

ATTACK  ROLE  ALL 

int 

AIR  SYM 

ATTACK  ROLE  GROUND 

int 

None  of  the  above. 

Calls 

Function 

Where  Described 

symbols  match 

Sec.  2.1.1 .5  See  Appendix  A 

Table  2.6-410:  map_role_sym_to_role_number  CSU  [8.6.9.3.1] 
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2. 6. 9. 3. 2  create_targeting  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

Mable 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

1  Calls  1 

Function 

Where  Described  1 

allocate  taraetinq 

1  II 1  — 

ft  float 

Sec.  2.14.1.2.12 

ft  symbol 

Sec.  2.14.1.2.13 

init  taraet  fist 

Sec.  2.6.9.3.6 

vec  init 

Sec.  2.6.2.31.1  Vehicles  CSCI  SDD 

symbols  match 

Sec.  2.1. 1.5  See  Appendix  A 

map_role_sym_to_role_ 

number 

Sec.  2.6.9.3.1 

Table  2.6-411:  create_targeting  CSU  [8.6.9.3.2] 


2. 6. 9. 3. 3  destroy_targeting  CSU 

This  CSU  removes  a  targeting  structure  from  memory  by  deaUocating  the  space  previously 
reserved. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

Maroetina 

pointer  to  TARGETING  VARS 

Sec.  2.9.1 .2 

1  Calls  1 

Function 

1  Where  Described  1 

deallocate  tarqeting 

Table  2.6-412:  destroy_targeting  CSU  [8.6.9.3.3] 


2. 6. 9. 3. 4  firestatus_to_string  CSU 

This  CSU  converts  a  firestatus  symbolic  constant  to  a  character  string. 


Parameters 

Parameters 

Type 

Where  Typedef  Declared 

s 

unsigned  char 

Standard 
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1  ReturnValues  1 

Return  Value 

Type 

Meaning 

"hold" 

pointer  to  char 

FIRESTATUS  HOLD  FIRE 

"Tire  at  will" 

pointer  to  char 

FIRESTATUS  FIRE 

AT  WILL 

"fire  at  designated" 

pointer  to  char 

FIRESTATUS  FIRE  AT 
DESIGNATED  TARGETS 

"fire  with  leader" 

pointer  to  char 

FIRESTATUS  FIRE  AT 
WHAT  LEADER  SHOOTS 

"fire  at  position" 

pointer  to  char 

FIRESTATUS  FIRE  AT 
TOSITION 

"unknown" 

pointer  to  char 

None  of  the  above. 

Table  2.6-413:  rirestatus_to_string  CSU  [8.6.9.3.4] 


2. 6. 9. 3. 5  targeting_show  CSU 


This  CSU  displays  targeting  infomiadon  from  a  TARGETING_VARS  data  structure. 


1  Parameters  1 

Parameters 

Where  Tvpedef  Declared 

*td 

pointer  to  TARGETING  VARS 

Sec.  2.9.1. 2 

int 

Standard 

1  Calls  1 

Function 

Where  Described 

firestatus.to  string 

Sec.  2.6.9.3.4 

Table  2.6-414:  targeting_show  CSU  [8.6.9.3.5] 


2. 6. 9. 3. 6  init_target_list  CSU 

This  CSU  sets  the  first  element  of  the  target  list  and  the  target  element  in  a 
TARGETING_VARS  data  structure  to  zero. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*td 

pointer  to  TARGETING  VARS 

Sec.  2.9.1. 2 

Table  2.6-415:  init_targeMist  CSU  [8.6.9.3.6] 


2. 6. 9. 3. 7  set_targeMist  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*td 

pointer  to  TARGETING  VARS 

Sec.  2.9.1. 2 

*1 

unsigned  short 

Standard 

Table  2.6-416:  set_targeMist  CSU  [8.6.9.3.7] 
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2. 6. 9. 3. 8  targeting_set_fire_at_pointair  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

X 

REAL 

Sim  tvpes.h 

V 

REAL 

sim  tvpes.h 

r 

REAL 

Table  2.6-417:  targeting_set_fire_at_pointair  CSU  [8.6.9.3.8] 


2. 6. 9. 3. 9  targeting_set_hold_fire  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9. 1.1 

Table  2.6-418:  targeting_set_hoId_fire  CSU  [8.6.9.3.9] 


2.6.9.3.10  targeting_set_fire_at_will  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

Table  2.6-419:  targeting_set_fire_at_will  CSU  [8.6.9.3.10] 


2.6.9.3.11  targeting_set_parameters  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

•td 

pointer  to  TARGETING  VARS 

Sec.  2.9.1. 2 

firestatus 

int 

Standard 

max  enaaoement  range 

REAL 

sim  types. h 

marksmanship 

REAL 

sim  types.h 

position  X 

REAL 

sim  types.h 

position  y 

REAL 

sim  types.h 

radius 

REAL 

sim  tvpes.h 

targetsfl 

unsigned  short 

Standard 

Table  2.6-420:  targeting_set_parameters  CSU  [8.6.9.3.11] 
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Table  2.6-421:  TARGET_ITEM  Structure  Definition 
2.6.9.3.13  init_target_itenis  CSU 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*tara 

pointer  to  TARGET  ITEM 

Sec.  2.6.9.3.12 

Table  2.6-422:  init_targeMtenis  CSU  [8.6.9.3.13] 


2.6.9.3.14  conipare_targets  CSU 

This  CSU  is  used  to  sort  target  priorities.  The  lower  of  two  target  priority  numbers  has  the 
higher  priority. 

I 


Table  2.6-423:  conipare_targets  CSU  [8.6.9.3.14] 


2.6.9.3.15  target_priority  CSU 

This  CSU  sets  a  target's  priority  for  targeting.  It  is  currently  used  only  by  attacking  air 
vehicles  on  their  targets. 


I  Parameters  I 

I  Parameters 

Type 

Where  Typedef  Declared 

ObiectTvpe 

p  sim.h 

I  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*item1 

pointer  to  TARGET  ITEM 

Sec.  2.6.9.3.12 

*item2 

pointer  to  TARGET  ITEM 

Sec.  2.6.9.3.12 

Return  Values 

Return  Value 

Type 

Meanina 

priority  diff 

int 

Target  priorities  used. 

(int)(item1->range2  -  item2-> 
range2) 

int 

Distance  used. 

2.6.9.3.12  TARGET  ITEM  CSU 


This  CSU  contains  a  TARGET_ITEM  structure  definition  used  by  the  target  code  to  sort 
potential  targets  into  a  target  list.  The  structure  has  no  tag. 


Item 

Type 

Where  Type  Defined 

D 

unsigned  short 

Standard 

ranae2 

REAL 

Sim  types.h 

priority 

int 

Standard 
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Table  2.6>424:  target_priority  CSU  [8.6.9.3.15] 


2.6.9.3.16  target_type_ok  CSU 


This  CSU  compares  the  caller's  object  type  with  an  enemy  and  sees  if  the  caller  can  legally 
engage  him. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

attacker  object  type 

ObjectTvoe 

p  sim.h 

tarqetlO 

unsigned  short 

Standard 

attack  role 

unsiqned  char 

Standard 

mil  ■  hi  hii— — 

pointer  to  int 

Standard 

1  ReturnVaiues  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

No  target,  or  no  attack  role,  or 
target  is  dead,  or  target  is  fast 
helicopter,  or  none  of  the 
below. 

TRUE 

int 

Attacker  is  aircraft,  or  target  is 
ground  vehicle,  or  attack  role 
is  air  or  all. 

IS  AIRCRAFT!...) 

int 

Attacker  is  antiaircraft. 

check  prob(.10) 

int 

Target  is  slow  helicopter. 

BBN  Systems  and  Technologies 
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Table  2.6-425:  target_type_ok  CSU  [8.6.9.3.16] 


2.6.9.3.17  target_in_position  CSU 

This  CSU  checks  to  see  if  the  enemy  target  is  close  to  a  position  at  which  the  caller  is 
allowed  to  shoot. 


Parameters 


must  be  near 


s 


s 


radiusz 


ranqe2 


IBT:! 


Parameters 


immmi 


int 


inter  to  REAL 


inter  to  REAL 


REAL 


inter  to  REAL 


irs 

irs 


irs 


Where  Typedef  Declared 


Standard 


sim  t 


Sim  t 


Sim  t 


sim  t 


Return  Value 


TRUE 


FALSE 


I  EH? 


ReturnValues 


Meanin 


must_be_near==FALSE  or 
*ranae2<radius2. 


must_be_near==TRUE  and 
*ranae2>=radius2 


Function 


ranoe  squared 


Calls 


Where  Described 


Sec.  2.14.3.5.10 


Table  2.6-426:  target_in_position  CSU  [8.6.9.3.17] 
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2.6.9.3.18  select_weapon_priority_list  CSU 


This  CSU  selects  a  weapon  priority  list  for  a  given  object  type. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*td 

pointer  to  TARGETING  VARS 

Sec.  2.9.1. 2 

*wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Sec.  2.9.1 .2 

object  type 

ObiectType 

p  sim.h 

RetumValues 

Return  Value 

Type 

Meanina 

&wsd->tank_priorityJist 

pointer  to 

WEAPON  PRIORITY  LIST 

Object  type  is  tank. 

&wsd->tank_airjist 

pointer  to 

WEAPON  PRIORITY  LIST 

Object  type  is  aircraft. 

&wsd->tank_ground_list 

pointer  to 

WEAPON  PRIORITY  LIST 

Object  type  is  neither  tank  nor 
aircraft. 

Calls 

Function 

Where  Described 

IS  TANK 

IS  AIRCRAFT 

Table  2.6-427;  select_weapon_priority_list  CSU  [8.6.9.3.18] 


2.6.9.3.19  update_targeMist  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safob| 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described 

OBJ  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

OBJ  OBJECT  TYPE 

Sec.  2.9.1. 1  See  Appendix  A 

init  taraet  list 

Sec.  2.6.9.3.6 

init  taraet  items 

Sec.  2.6.9.3.13 

taraet  type  ok 

Sec.  2.6.9.3.16 

LOOKUP  POSITION 

Sec.  2.9.1. 1  See  ^)pendix  A 

taraet  in  position 

Sec.  2.6.9.3.17 

ranae  sauared 

Sec.  2.14.3.5.10 

asort 

min 

Sec.  2.6  7.3  &  Sec.  2.13.3.5  See  Appendix  A 

Table  2.6-428:  update_targeMist  CSU  [8.6.9.3.19] 
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2.6.9.3.20  choose_target_and_weapon  CSU 


Parameters 


Parameters 


td 


wsd 


irs 


inter  to  TARGETING  VARS 


pointer  to 

WEAPON  SYSTEMS  VARS 


Where  Typedef  Declared 


Sec.  2.9.1 .2 


Sec.  2.9.1. 2 


sition  1 

[to 

inter  to  REAL  1 

1  Sim 

unsioned  int 


Standard 


Function 


LOOKUP  SAFOBJ 


OBJ  POSITION 


OBJ  VELOCITY 


OBJ  OBJECT  TYPE 


ranoe  squared 


intervis  can  see  Dt  to  ot 


select  weaoon  orioritv  list 


DEBUG  TARGETING 


Calls 


Where  Described 


Sec.  2.14.3.5.10 


Sec.  2.6.5.2.1 


Sec.  2.6.9.3.18 


ndix  A 


endix  A 


ndix  A 


ndix  A 


endix  A 


Table  2.6*429:  choose_target_and_weapon  CSU  [8.6.9.3.20] 


2.6.9.3.21  targeting_tick  CSU 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

detection  tick 

Sec.  2.6.5.1.11 

major  detection  increase 

Sec.  2.6.5.1.13 

major  spotter  increase 

Sec.  2.8.2.3.10 

detection  save  weiqht 

Sec.  2.6.5.1.12 

spotter  save  weiqht 

Sec.  2.8.2.3.11 

update  tarqet  list 

Sec.  2.6.9.3.19 

qet  me  a  random  fraction 

Sec.  2.14.3.7.1 

choose  tarqet  and  weapon 

Sec.  2.6.9.3.20 

OBJ  POSITION 

OBJ  VEHICLEID 

Sec.  2.9.1. 1  See  Appendix  A 

loader  tick 

Sec.  2.6.9.10.1 

qunner  tick 

Sec.  2.6.9  5.7 

Table  2.6-430:  targetingjick  CSU  [8.6.9.3.21] 
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2. 6. 9. 4  targeting.h  CSU 

/simnet/src/host/targeting.h 


This  CSU  contains  the  symbolic  constants  used  by  the  targeting  code. 


1  Constant 

Value 

[MAXIMUM  TARGETS  TO  SORT 

/*  Maximum  #  of  taroets  to  sort  7 

16 

[MAXIMUM  TARGETS  /*  Maximum  #  of  taiaels  to  consider  in  a  taroet  fst  */ 

8 

1 RRESTATUS  HOLD  RRE 

rurina  status  7 

FIRESTATUS  FIRE  AT  WILL 

1 

FIRESTATUS  FIRE  AT  POSITION 

2 

FIRESTATUS  FIRE  AT  WHAT  LEADER  SHOOTS 

3 

FIRESTATUS  FIRE  AT  DESIGNATED  TARGET 

4 

FIRESTATUS  FIRE  AT  POINTAIR 

5 

[GUNNER  STATE  SCANNING 

r  Stales  that  ounner  can  be  in  7 

GUNNER  STATE  ACQUIRING 

1 

GUNNER  STATE  ACQUIRED 

2 

GUNNER  STATE  TRACKING 

3 

GUNNER  STATE  TRACKED 

4 

GUNNER  STATE  FLYING  ROUND 

5 

GUNNER  STATE  LOST  VISIBILITY 

6 

[ACQUIRE  RESULT  OK 

ACQUIRE  RESULT  TARGET  DEAD 

1 

ACQUIRE  RESULT  TARGET  GONE 

2 

[TRACK  RESULT  LOCKED  ON 

r  Results  of  tryina  to  track  a  taraet  7 

TRACK  RESULT  TRYING 

1 

TRACK  RESULT  TARGET  DEAD 

2 

TRACK  RESULT  TARGET  GONE 

3 

TRACK  RESULT  TARGET  NOT  VISIBLE 

4 

[ATTACK  ROLE  NONE 

r  Attack  roles  7 

ATTACK  ROLE  ALL 

1 

ATTACK  ROLE  GROUND 

2 

ATTACK  ROLE  AIR 

3 

TARGET  PRIORITY  ADA  T  Tarqet  priority  list,  lowest  number  enaaoed  first  V 

TARGET  PRIORITY  AIR 

1 

TARGET  PRIORITY  TANK 

2 

TARGET  PRIORITY  DEFAULT 

3 

Table  2.6-431:  targeting.h  Constant  Definitions 
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2. 6. 9.5  gunner.c  CSC 

/simnet/sic/host/gunner.c 

This  CSC  handles  tracking  a  chosen  target,  bringing  a  weapcm  to  bear  on  this  target,  firing 
die  weapon,  and  delivering  a  round  to  the  target. 


gunn«r.c 

CSC 

S.6.9.5 


/ - r-* - 

acquire  target 

CSU  8.6.9.5.1 

DC 

track  target 
CSU  e.6.9.S.2 

DC 

— : - ' - N 

point  weapon  at  target 
CSU  8.6.9.5.3  ^ 

1 

1  ■ 

1 

^  scan  weapon 

^  CSU  8.6.9.5.4 

DC 

shoot  target 
CSU  8.6  9.5.5 

DC 

gunner  round  flying 
CSU  8.6.9.5.6 

c 


1 


gunner_tick 
CSU  fl.6.9.5.7 


Figure  2.6-38:  gunner.c  CSC  Structure 


2. 6. 9. 5.1  acquire_target  CSU 

This  CSU  perfomis  target  acquisition  for  a  given  weapon  and  target. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

*weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9. 1.2 

taroetlD 

unsigned  short 

Standard 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

ACQUIRE  RESULT 

TARGET  GONE 

int 

No  target. 

ACQUIRE  RESULT 

TARGET  DEAD 

int 

Dead  target. 

ACQUIRE  RESULT  OK 

int 

1  Calls  1 

Function 

Where  Described  1 

LOOKUP  VEHICLE 

is  dead 

LOOKUP  APPEARANCE 

LOOKUP  VEHICLECLASS 

point  .weapon  at  target 

Sec.  2.6.9.5.3  1 

Table  2.6-432:  acquire_target  CSU  [8.6.9.5.1] 
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2. 6. 9. 5. 2  track_target  CSU 

This  CSU  performs  target  tracking  for  a  given  weapon  and  target. 


Parameters 


safobi 


Parameters 


inter  to  SAP  OBJECT 


inter  to  WEAPON  VARS 


unsioned  short 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.9. 1.2 


Standard 


ReturnValues 


Return  Value 


TRACK_RESULT_TARGET_ 

GONE 


TRACK_RESULT_TARGET_ 

DEAD 


TRACK_RESULT_TARGET_ 
NOT  VISIBLE 


TRACK_RESULT_LOCKED 

ON 


TRACK  RESULT  TRYING 


Meanin 


No  target. 


Dead  target. 


Target  not  visible. 


Weapon  successfully  pointed 
at  taroet. 


None  of  the  above. 


Function 


OBJ  VEHICLEID 


OBJ  POSITION 


LOOKUP  POSITION 


LOOKUP  VELOCITY 


LOOKUP  VEHICLE 


is  dead 


LOOKUP  APPEARANCE 


intervis  can  see  ot  to  pt 


radiate  target 


int  weacxin  at  target 


Calls 


Where  Described 


Sec.  2.6.5.2.1 


Sec.  2.6.9.8.19 


Sec.  2.6  9.5.3 


endix  A 


endix  A 


endix  A 


endix  A 


endix  A 


ndix  A 


endix  A 


Table  2.6-433:  track_target  CSU  [8.6.9.5.2] 


2. 6. 9. 5. 3  point_weapon_at_target  CSU 
This  CSU  points  the  weapon  at  the  target. 
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ReturnValues 


Return  Value 


int  at  taroet 


int  at  taroet 


FALSE 


Meanin 


mm 

rasiia 


Int 

Turreted  weapon. 

int 

Air  vehicle. 

int 

None  of  the  above. 

m 


Function 


turret  tx>int  at  taroet 


int  at  taroet 


Ca 


Where  Described 


Sec.  2.6.9.6.5 


Sec.  2.6.4.2.50 


Table  2.6-434:  point_weapon_at_target  CSU  [8.6.9.5.3] 


2. 6. 9. 5. 4  scan_weapon  CSU 

This  CSU  causes  the  turret  to  scan. 


Parameters 


Parameters 


weapon 


inter  to  SAF  OBJECT 


inter  to  WEAPON  VARS 


Where  Tyoedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.9.1. 2 


Function 


turret  scan 


Calls 


Where  Described 


Sec.  2.6.9.6.6 


Table  2.6-435:  scan_weapon  CSU  [8.6.9.5.4] 


2. 6. 9. 5. 5  shoot_target  CSU 

This  CSU  attempts  to  fire  a  weapon  at  a  target. 


Parameters 


Parameters 


safobi 


weapon 


inter  to  SAF  OBJECT 


inter  to  WEAPON  VARS 


unsioned  short 


Where  Tvpedef  Declared 


Sec.  2.9.1. 1 


Sec.  2.9.1. 2 


Standard 


ReturnValues 


Return  Value 


ROUND_NOT_SHOT_ 

BECAUSE_OF_NO_LOS 


ROUND  AWAY 


ROUND  NOT_SHOT_ 
BECAUSE  OF  NO  LEAD 


Meanin 


We^n  not  fired  because  of 
no  line-of-sight  visibility  to  the 


Weapon  fired. 


Weapon  not  tired  because  of 
no  line_of_sight  visibility  to 
the  predicted  taroet  position. 


413 


BBN  Systems  and  Technologies 


SAF  Simulation  Host  CSCI 


1  Calls  1 

Function 

Where  Described  1 

OBJ  VEHICLEID 

kgaWOtlKcgl  1  II  III——— 

OBJ  POSITION 

LOOKUP  VELOCITY 

sal  vehicle  est  position 

Sec.  2.6.1.1.58  1 

LOOKUP  SAFOBJ 

intervis  can  see  pt  to  pt 

Sec.  2.6.5.2.1 

fire  missile  at  tarpet 

Sec.  2.6.9. 1.6 

ranae  squared 

Sec.  2.14.3.5.10 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDO 

fire  weapon  at  target 

Sec.  2.6.9.8.21 

Table  2.6>436:  shoot_target  CSU  [8.6.9.5.5] 
2. 6. 9. 5. 6  gunner_round_fIymg  CSU 

This  CSU  sets  the  gunner  state  to  GUNNER_STATE_FLYING_ROUND. 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*td 

pointer  to  TARGETING  VARS 

Sec.  2.9. 1.2 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

td*>gunner  state 

GUNNER  STATE  FLYING 
ROUND 

int 

Gunner  state  set. 

Table  2.6-437;  gunner_round_nying  CSU  [8.6.9.5.6] 

2. 6. 9. 5. 7  gunner_tick  CSU 

This  CSU  performs  the  gunner's  tasks.  The  gunner's  job  is  to  acquire,  track,  and  shoot 
the  chosen  target  with  the  chosen  weapon.  If  he  doesn't  have  a  target,  he  "scans"  his 
weapon. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

1  Calls  1 

Function 

Where  Described  1 

OBJ  VEHICLEID 

DEBUG  GUNNER 

Sec.  2.5.2.2  See  Appendix  A 

scan  weapon 

Sec.  2.6  9.5.4 

Llii!  iilliiMMt*  yAHiHHHH 

Sec.  2.6.9.5.1 

track  tarqet 

Sec.  2.6.9.5  2 

shoot  target 

Sec.  2.6.9.5.5 

fly  round 

Sec.  2.6.9.8.22 

Table  2.6-438:  gunner^tick  CSU  [8.6.9.5.7] 
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2. 6. 9. 6  turretc  CSC 

/simnet/src/host/tuneLc 

This  CSC  contains  the  code  dealing  with  turret  issues,  including  slewing,  scanning,  target 
tracking,  and  taking  dannage. 


r  crsate  turret 

V  CSU  8.6.9.6.1 

DC 

destroy  turret 

CSU  8.6.9.6.2 

DC 

turret  show  'N 

CSU  8^.9.6.3  J 

1  ■ 

1  "■ 

1 

f  turret  slew 

V  CSU  8.6.9.6.4 

DC 

turret_point  at  target 
CSU  8.69.6.5 

DC 

turret  scan  ^ 

CSU  8.6.9.66  J 

1  ■ 

1  ■ 

1 

^  turret_muzzle_position. 
1  woridjcoordinates 

DC 

turret  set  scan_parins 
CSU  8.6.9.6  8 

DC 

turret  interest  dir  ^ 

CSU  8.6.96.9  J 

CSUi 


-  I _ _ 

(turret_firepower_kill 

CSU  8  6.9.6.10  J 

Figure  2.6-39:  turret.c.c  CSC  Structure 
2. 6. 9. 6.1  create_turret  CSU 

This  CSU  allocates  memory  space  for  a  TURRET_VARS  data  structure  and  initializes  its 
members. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

*table 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

ReturnValues 


Return  Value 

Type 

Meaning 

tur 

pointer  to  TURRET  VARS 

Turret  created. 

1  Calls  1 

Function 

1  Where  Described  1 

allocate,  turret 

dea  to  rad 

Sim  macros.h 

ft  float 

Sec.  2.14.1.2.12 

Table  2.6-439:  create  turret  CSU  [8.6.9.6.1] 
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2. 6. 9. 6. 2  destroy_turret  CSU 

This  CSU  uses  deallocate.turret  to  deallocate  memory  space  previously  reserved  for  a 
TURRET_VARS  data  structure. 


1  Parameters  1 

Parameters 

Tvoe 

Where  Typedef  Declared 

*tur 

pointer  to  TURRET  VARS 

Sec.  2.9. 1.2 

1  Calls  1 

Function 

Where  Described  1 

deallocate  turret 

Table  2.6*440:  destroy_turret  CSU  [8.6.9.6.2] 


2. 6. 9. 6. 3  turret_show  CSU 

This  CSU  displays  turret  information  from  a  TURRET_VARS  data  structure. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*tur 

pointer  to  TURRET  VARS 

Sec.  2.9.1. 2 

flaos 

int 

Standard 

Calls 

Function 

Where  Described 

rad  to  deg 

sim_macros.h 

Table  2.6-441:  turret  show  CSU  [8.6.9.6.3] 


2. 6. 9. 6. 4  turret_slew  CSU 

This  CSU  moves  the  turret  to  a  requested  azimuth  and  elevation. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

azimuth  rps 

REAL 

Sim  types. h 

elevation  rps 

REAL 

Sim  types.h 

ReturnValues 

Return  Value 

Type 

Meaning 

azimuth_satisfied  && 
elevation_satisfied 

int 

1  if  succeeded,  0  if  failed  to 
reach  both  azimuth  and 
elevation. 
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Calls 

Function 

Where  Described 

OBJ  TIME  SINCE  LAST 
TICK 

Sec.  2.9.1. 1  See  Appendix  A 

Sec.  2.14.3.5.4 


abs 


RANGE  CLIP 


DEBUG  TURRET 


OBJ  VEHICLEID 


OBJ  TURRETAZIMUTH 


radians  to  simnet  anole 


sitive 


OBJ  GUNELEVATION 


Sec.  2.6.7.3  &  Sec.  2.13.3.2  See 


ndix  A 


endix  A 


ndix  A 


ndix  A 


ndix  A 


Sec.  2.14.3.5.5 


endix  A 


Table  2.6-442:  turret_slew  CSU  [8.6.9.6.4] 


2. 6. 9. 6. 5  turret_point_at_target  CSU 


This  CSU  calculates  the  desired  azimuth  and  elevation  and  rates  of  travel  to  point  the  turret 
at  the  target 


\  Parameters  1 

Parameters 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

targetIO 

unsigned  short 

Standard 

1  ReturnValues  1 

Return  Value 

BTrmmmmmmmm 

Meaning 

FALSE 

int 

Turret  trashed. 

turret  slew(...) 

int 

Normal  end. 

1  Calls  1 

Function 

Where  Described 

vec  sub 

Sec.  2.6.2.35.1  Vehicles  CSCI  SDD 

LOOKUP  POSITION 

OBJ  POSITION 

Sec.  2.9. 1.1  See  Appendix  A 

mat  vec  mul 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

OBJ  HULL  TO  WORLD 

vec  maa3 

Sim  macros.h  I 

s  atan2 

angle  clip 

Sec.  2.14.3.5.4 

abs 

Sec.  2.6  7.3  &  Sec.  2.13.3.2  See  Appendix  A 

turret  slew 

Sec.  2.6.9.6.4 

Table  2.6-443:  turret_point_at_target  CSU  [8.6.9.6.5] 
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2. 6. 9. 6. 6  turret_scan  CSU 

This  CSU  performs  the  calculations  for  scanning  the  turret 


Parameters 


Parameters 


inter  to  SAP  OBJECT 


Where  Tvoedef  Declared 


Sec.  2.9.1. 1 


Function 


r 


et  me  a  random  fraction 


DEBUG  TURRET 


OBJ  VEHICLEID 


rad  to  de 


turret  slew 


nn 


Ca 


Where  Described 


Sec.  2.14.3.5.4 


Sec.  2.14.3.7.1 


Sec.  2.5.2.2  See 


Sim  macros.h 


Sec.  2.6.9.6.4 


rxiix  A 


ixtix  A 


Table  2.6*444:  turret  scan  CSU  [8.6.9.6.6] 


2. 6. 9. 6. 7  turret_niuzzle_position_in_world_coordinates  CSU 


1  Parameters  1 

Parameters 

Tvoe 

Where  Tvpedef  Declared 

Mur 

DOinter  to  TURRET  VARS 

*DOS 

pointer  to  REAL 

Sim  tvpes.h 

**htw 

DOinter  to  Dointer  to  REAL 

Sim  tvpes.h 

•muzzle  vec 

pointer  to  REAL 

Sim  tYPes.h 

Calls 

Function 

Where  Described 

vec  mat  mul 

Sec.  2.6.2.56.1  Vehicles  CSCl  SDD 

vec  add 

Sec.  2.6.2.57.1  Vehicles  CSCl  SDD 

Table  2.6-445:  turret_niuzzle_position_in_world_coordinates  CSU 

[8.6.9.6.7] 


2. 6. 9. 6. 8  turret_set__scan_parnis  CSU 


This  CSU  sets  scan  parameters. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1 .1 

left 

REAL 

Sim  tvpes.h 

riaht 

REAL 

Sim  tvpes.h 
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1  Calls  1 

Function 

Where  Described 

IS  ANTIAIRCRAFT 

OBJ  OBJECT  TYPE 

Sec.  2.9.1. 1  See  Apoendix  A 

deq  to  rad 

Sim  macros.h 

Table  2.6-446: 

turret_set_scan_parnis 

CSU  [8.6.9.6.8] 

2. 6. 9. 6. 9  turreMnterest_dir  CSU 

1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•vec 

pointer  to  REAL 

1  Calls  1 

Function 

Where  Described 

vec  mat  mul 

Sec.  2.6.2.56.1  Vehicles  CSCI  SDD 

OBJ  HULL  TO  WORLD 

Sec.  2.9. 1.1  See  Appendix  A 

Table  2.6-447;  turret_interest_dir  CSU  [8.6.9.6.9] 


2.6.9.6.10  turret_firepower__kill  CSU 

This  CSU  kills  turret  firepower  by  setting  turret_trashed  to  TRUE. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

*tur 

pointer  to  TURRET  VARS 

Sec.  2.9. 1.2 

Table  2.6-448;  turret_firepower_kill  CSU  [8.6.9.6.10] 

2. 6. 9. 7  turret.h  CSU 

/simnet/src/host/turret.h 

This  CSU  contains  the  symbolic  constants  used  by  the  turret  code. 


Constant 

Value 

MAX  SCAN  IDLE  TIME 

30000 

MIN  SCAN  IDLE  TIME 

10000 

SCAN  STATE  SCANNING 

0 

SCAN  STATE  WAITING 

1 

Table  2.6-449:  turret.h  Constant  Definitions 
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2. 6. 9. 8  weapons.c  CSC 
/simnet/src/hosl/weapons.c 

This  CSU  contains  the  code  which  controls,  selects,  and  de-selects  any  particular  weapon. 
It  also  handles  the  actual  tracking  of  a  round  to  target,  firing  the  weapon,  and  the  round 
impact  and  hit  upon  arrival. 

weapons.c 

CSC 

8.6.9.8 


f  weapon  state  to  string  A 

V  CSU  8.6.9  8. 1  J 

f  create  weapon  systems^  f  destroy  weapon  systems^ 

V  CSU8.6.9.8.2  J  V  CSU  8.9.6.8.3  J 

.  1  ^ 
f  weapon  configure  > 

V  CSU  8.6.9.8.4  J 

r  weapon  systoms_show  ^  f  weapon_show  j 

V  CSU  8.6.9  8.5  J  V  CSU  8.6.9.8  6  J 

^ - 1 - - 

f  weapon_priority  list  show  A 
V.  CSU  8.6.9.8.7  J 

r  weapon  systems  rearm  ^  f  weapon  systems  checkpoints 

V  CSU  8.6.9  8.8  J  V  CSU  8.6.9.8  9  J 

r  weapon  systems  reinit 

V  CSU  8.6.9.8.10  J 

^  dear  weapons  status  A  f  add  weapons  status  "N 

V  CSU  8.6.9.8.11  J  V  CSU  8.6.9.8.12  J 

r  initialize_weapon_priority  'N 
V  list  CSU  8.6.9.8.13  J 

f  weapon  select  'N  f  weapon  deselect  N 

V  CSU  8.6.9.8.14  J  V  CSU  8.6.9.8.15  J  W 

f  weapon  load  ^ 

V  CSU  8.6.9.8.16  J 

T  1 

r  weapon_unload  A  f  muz2le_posrtionJn_world_'\ 

V  CSU  8.6.9.8.17  J  Vcoordinates  CSU  8.6.9.8.18^ 

f  radiate  target 

k  CSU  8.6.9.8.19  J 

r  get  relative  vehicle  agility f  fire  weapon  at  target 

V  CSU  8.6.9.8.20  J  V  CSU  8.6.9.8.21  J 

Parameters 
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ReturnValues 


Return  Value 


"not  selected" 


"selecting" 


"selected 


loadin 


loaded 


unloading 


"deselecting" 


unknown" 


pointer  to  char 


pointer  to  char 


pointer  to  char 


inter  to  char 


inter  to  char 


pointer  to  char 


pointer  to  char 


inter  to  char 


fileanln 


WEAPON_STATE_NOT_ 

SELECTED 


WEAPON_STATE_ 

SELECTING 


WEAPON_STATE_ 

SELECTED 


WEAPON  STATE  LOADING 


WEAPON  STATE  LOADED 


WEAPON_STATE_ 

UNLOADING 


WEAPON_STATE_ 

DESELECTING 


None  of  the  above. 


Table  2.6-450:  weapon_state_to_string  CSU  [8.6.9.8.1] 


2. 6. 9. 8. 2  create_weapon_systems  CSl) 


This  CSU  allocates  memory  space  for  a  WEAPON_SYSTEMS_VARS  data  structure, 
configures  the  weapons,  initializes  the  default  weapon,  and  initializes  the  tank,  air,  and 
ground  weapon  priority  lists. 


1  Parameters  1 

{Parameters  I 

Where  Typedef  Declared 

pointer  to  DATA  UNION 

Sec.  2.1. 1.5 

ownerlD 

unsigned  short 

Standard 

force  ID 

ForcelD 

basic,  h 

percent  ammo 

REAL 

Sim  types. h 

1  ReturnValues  1 

Return  Value 

Type 

Meaning 

NULL 

pointer  to 

WEAPON  SYSTEMS  VARS 

Unable  to  configure  a  weapon. 

wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Created  data  stmcture. 

1  Calls  1 

Function 

Where  Described 

allocate  weapon  systems 

Sec.  2.9. 1.2  See  Appendix  A 

ft  table 

Sec.  2.14.1.2.14 

ft  symbol 

Sec.  2.14.1.2.13 

find  tao 

Sec.  2.1. 1.4.3 

DEBUG  WEAPON 

Sec.  2. 5.2.2  See  Appendix  A 

weapon  confiaure 

Sec.  2.6.9.8  4 

symbols  match 

Sec.  2. 1.1. 5  See  Appendix  A 

initialize  weapon  priority  list 

Sec.  2.6.9.8.13 

Table  2.6-451:  create_weapon_systems  CSU  [8.6.9.8,2] 
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2. 6. 9. 8. 3  destroy_weapon_systeins  CSU 

This  CSU  deallocates  memory  space  previously  reserved  for  a 
WEAPON_SYSTEMS_VARS  ^ta  structure.. 


Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

•wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Sec.  2.9.1. 2 

Calls  1 

Function 

Where  Described 

destroy  missile 

Sec.  2.6  9.1. 4 

deallocate  weapon  systems 

1  1  1  III  1— 

Table  2.6-452:  destroy _weapon_systeiiis  CSU  [8.6.9.8.3] 


2. 6. 9. 8. 4  weapon_configure  CSU 

This  CSU  initializes  the  weapon  configuration. 


Parameters 


table 


ownerlO 


forcelD 


ercent  ammo 


IflT^ 
irs 
irs 


Parameters 


inter  to  WEAPON  VARS 


inter  to  DATA  UNION 


unsioned  short 


ForcelD 


REAL 


Where  Tyoedef  Declared 


Sec.  2.9.1. 2 


Sec.  2.1. 1.5 


Standard 


basic.h 


Sim  t 


Function 


ft  symbol 


find  ta 


ft  int 


ft  float 


create  missile 


Calls 


Where  Described 


Sec.  2.14.1.2.13 


Sec.  2.1. 1.4.3 


Sec.  2.14.1.2.11 


Sec.  2.14.1.2.12 


Sec.  2.6.9. 1.3 


Table  2.6-453:  weapon_configure  CSU  [8.6.9.8.4] 


2. 6. 9. 8. 5  weapon_systems_show  CSU 

This  CSU  displays  weapon  systems  information  from  a  WEAPON_SYSTEMS_VARS 
data  structure. 
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1  Calls  1 

Function 

Where  Described 

weapon  show 

Sec.  2.6.9  8.6 

weapon  priority  list  show 

Sec.  2.6.9.8  7 

Table  2.6-454:  weapon_systeins_show  CSU  [8.6.9.8.5] 


2. 6. 9. 8. 6  weapon_show  CSU 

This  CSU  displays  weapon  configuration  infcnmation  from  a  WEAPON_VARS  data 
structure. 


1  Parameters  1 

Parameters 

Type 

Where  Tvpedef  Declared 

•weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

Calls 

Function 

Where  Described 

weapon  state  to  strino 

Sec.  2.6.9.8.1 

missile  show 

Sec.  2.6.9. 1.5 

Table  2.6-455:  weapon_show  CSU  [8.6.9.8.6] 


2. 6. 9. 8. 7  weapon_priority_list_show  CSU 

This  CSU  displays  the  selected  weapon  priority  list. 


1  Parameters  I 

Parameters 

Type 

Where  Typedef  Declared 

•wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Sec.  2.9. 1.2 

*wpl 

pointer  to 

WEAPON  PRIORITY  LIST 

Sec.  2.9.1. 2 

Table  2.6-456:  weapon_priority_list_show  CSU  [8.6.9.8.7] 


2. 6. 9. 8. 8  weapon_systems_rearin  CSU 


This  CSU  rearms  the  selected  weapon  systems 


1  Parameters  1 

Parameters 

Where  Typedef  Declared 

*wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Sec.  2.9.1. 2 

Table  2.6-457:  weapon_systems_rearm  CSU  [8.6.9.8.8] 
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2.6.9.8.13  initialize_weapon_priority_list  CSU 
This  CSU  initializes  a  weapon  priority  list 


i  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*wsd 

pointer  to 

WEAPON  SYSTEMS  VARS 

Sec.  2.9.1 .2 

*wpl 

pointer  to 

WEAPON  PRIORITY  LIST 

Sec.  2.9.1. 2 

*table 

DOirrterto  DATA  UNION 

Sec.  2.1. 1.5 

1  Errors  1 

Error  Name 

Reason  for  Error 

"Couldnl  find  weapon  ...  for 
priority  list" 

Unable  to  find  a  weapon  for  the  priority  list. 

1  Calls  1 

Function 

1  Where  Described  1 

symbols  match 

ERROR  OUT 

Sec.  2.5  2.2  See  Appendix  A  1 

Table  2.6-462:  initialize_weapon_priority_list  CSU  [8.6.9.8.13] 


2.6.9.8.14  weapon_select  CSU 
This  CSU  selects  a  weapon  on  a  vehicle. 


Parameters 


_ Calls 

Function _ 


DEBUG  WEAPON 

Table  2.6-463:  weapon_selectweapon_select  CSU  [8.6.9.8.14] 


symbols  match 


Where  Described _ 

Sec.  2. 1.1 .5  See  Appendix  A 
Sec.  2.5.2.2  See  ADoendix  A 


Where  Typedef  Declared 

Sec.  2.9.1. 1 _ 

Sec.  2.9.1. 2 


2.6.9.8.15  weapon_deseIect  CSU 
This  CSU  deselects  a  weapon  on  a  vehicle. 
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SAP  Simulation  Host  CSCI 


Parameters 


wsd 


Parameters 


Where  Tvpedef  Declared 


pointer  to  Sec.  2.9.1 .2 

WEAPON  SYSTEMS  VARS 


short  I  Standard 


Table  2.6-458:  weapon_systeins_checkpoiiit  CSU  [8.6.9.8.9] 


2.6.9.8.10  weapon_systems_reinit  CSU 


Parameters 


wsd 


Parameters 


Where  Tvoedef  Declared 


pointer  to  Sec.  2.9.1. 2 

WEAPON  SYSTEMS  VARS 


short  Standard 


Table  2.6-459:  weapon_systeins_reinit  CSU  [8.6.9.8.10] 


2.6.9.8.11  clear_weapons_status  CSU 


This  CSU  zeroes  weapons  status  data. 


Parameters 


*data 


lErn 


Parameters 


e 


pointer  to 

WEAPONS  STATUS  DATA 


Where  Tvpedef  Declared 


Sec.  2.9.1. 2 


Table  2.6-460:  clear_weapons_status  CSU  [8.6.9.8.11] 


2.6.9.8.12  add_weapons_status  CSU 


This  CSU  updates  weapons  status  data. 


Parameters 


wsd 


1073 


Parameters 


e  Where  Tvpedef  Declared 


pointer  to  Sec.  2.9.1. 2 

WEAPON  SYSTEMS  VARS 


pointer  to  Sec.  2. 9. 1.2 

WEAPONS  STATUS  DATA 


Function 


symbols  match 


Calls 


Where  Described 


endix  A 


Table  2.6-461:  add_weapons_status  CSU  [8.6.9.8.12] 
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1  Calls  1 

Function 

Where  Described 

symbols  match 

Sec.  P.1.1.5  SeeADoendixA 

DEBUG  WEAPON 

Table  2.6-464:  weapon_deselect  CSU  [8.6.9.8.15] 


2.6.9.8.16  weapon_load  CSU 


This  CSU  loads  a  weapon  that  is  mounted  on  a  vehicle. 


I  Parameters  I 

Parameters 

Where  Tvoedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1 .2 

1  Calls  1 

Function 

Where  Described 

DEBUG  WEAPON 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6-465:  weapon_load  CSU  [8.6.9.8.16] 


2.6.9.8.17  weapon_unload  CSU 


This  CSU  unloads  a  weapon  that  is  mounted  on  a  vehicle. 


Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

Calls 


Function 

Where  Described  1 

DEBUG  WEAPON 

Table  2.6-466:  weapon_unload  CSU  [8.6.9.8.17] 


2.6.9.8.18  muzzle_position_in_world_coordinates  CSU 


426 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


Table  2.6>467:  muzzle_position_iii_world_coordinates  CSU  [8.6.9.8.18] 


2.6.9.8.19  radiate^target  CSU 

This  CSU  radiates  the  target  with  radar,  after  verifying  that  it  is  necessary. 


Parameters 


attackerlD 


Parameters 


Where  Tvoedef  Declared 


unsioned  short  I  Standard 


inter  to  REAL  sim  t 


unsioned  short  Standard 


inter  to  WEAPON  VARS  I  Sec.  2.9.1. 2 


Function 


simnet  send  radiate 


Calls 


Where  Described 


Table  2.6*468:  radiate_target  CSU  [8.6.9.8.19] 


‘  2.6.9.8.20  get_relative_vehicle_agility  CSU 
This  CSU  returns  a  probability-of-hit  modifier  for  non-guided  rounds. 


427 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


ReturnValues 


Meanin 


1.0 

REAL 

Shooter  is  anti-aircraft;  or 
shooter  is  aircraft;  or 
target  is  ground  vehicle;  or 
shooter  is  ground  vehicle  and 
target  is  not  an  air  vehicle;  or 
none  of  the  below. 

0.01 

REAL 

Shooter  is  ground  vehicle  and 
target  is  plane. 

REAL 

Shooter  is  ground  vehicle  and 
target  is  slow  helicopter. 

0.1 

REAL 

Shooter  is  ground  vehicle  and 
target  is  fast  helicopter. 

Function 


IS  ANTIAIRCRAFT 


IS  AIRCRAFT 


IS  GROUNDVEH 


IS  PLANE 


IS  HELI 


VEC  SMALLER3 


Ca 


Where  Described 


Sec.  2.14.3.9  See 


ndix  A 


Table  2.6-469:  get_relative_vehicle_agllity  CSU  [8.6.9.8.20] 


2.6.9.8.21  fire_weapon_at_target  CSU 

This  CSU  fires  a  weapon  at  a  target.  It  calculates  whether  the  target  is  hit  or  not, 
modifying  the  probability  of  hit  according  to  target  agility  and  shooter  marksmanship. 


428 


BBN  Systems  and  Technologies 


SAP  Simulation  Host  CSCI 


Function 


OBJ  OBJECT  TYPE 


LOOKUP  OBJECT  TYPE 


LOOKUP  VELOCITY 


sat  vehicle  next  event  id 


muzzle j30SitionJn_world_ 
coordinates 


vec  sub 


vec  normalize 


vec  scale 


simnet  send  fire 


vec  CO 


intervis  oet  view 


database  hitmodel  aue 


et  relative  vehicle  aoilit 


check  orob 


DEBUG  WEAPON 


Calls 


Where  Described 


Sec.  2.6.1.1.28 


Sec.  2.6.9.8.18 


endix  A 


endix  A 


endix  A 


Sec.  2.6.2.65.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.63.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.64.1  Vehicles  CSCI  SDD 


Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 


Sec.  2.6.5.2.2 


endix  A 


Sec.  2.6.9.8.20 


Sec.  2.14.3.7.2 


endix  A 


Table  2.6-470:  fire_weapon_at_target  CSU  [8.6.9.8.21] 


2.6.9.8.22  fly_round  CSU 

This  CSU  does  the  calculations  for  a  round  or  a  missile  in  flight. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

targetID 

unsigned  short 

Standard 

1  ReturnValues  1 

Return  Value 

Meaning 

ROUND_DONE_FLYING 

int 

Burst  occurred  with 
conventional  round. 

ROUND_IN_FLIGHT 

int 

No  burst  occurred  with 
conventional  round. 

fly  missile!...) 

int 

It's  a  missile. 

1  Calls  1 

Function 

Where  Described 

impact  weapon 

Sec.  2.6.9.8.23 

track  target 

Sec.  2.6  9.5.2 

DEBUG  WEAPON 

Sec.  2.5.2  2  See  Appendix  A 

fly_  missile 

Sec.  2.6.9.1.11 

Table  2.6-471;  ny_round  CSU  [8.6.9.8.22] 
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2.6.9.8.23  impact_weapon  CSU 


This  CSU  decides  if  the  weapon  hit  or  missed  an  air  vehicle. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAP  OBJECT 

Sec.  2.9.1. 1 

*weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1 .2 

targetlD 

unsigned  short 

Standard 

Calls 

Function 

Where  Described 

LOOKUP  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

DEBUG  WEAPON 

Sec.  2.S.2.2  See  Appendix  A 

generate  weapon  miss 

Sec.  2.6.9.8.25 

generate  weapon  hit 

Sec.  2.6.9.8.24 

Table  2.6-472:  impact_weapon  CSU  [8.6.9.8.23] 


2.6.9.8.24  generate_weapon_hit  CSU 
This  CSU  generates  a  weapon  hit. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

•weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

targetlD 

unsigned  short 

Standard 

1  Calls  1 

Function 

1  Where  Described  1 

OBJ  VEHICLEID 

OBJ  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

LOOKUP  POSITION 

Sec.  2.9.1. 1  See  Appendix  A 

LOOKUP  HULL  TO 

WORLD 

Sec.  2.9.1 .1  See  Appendix  A 

LOOKUP  VEHICLECLASS 

Sec.  2.9.1 .1  See  Appendix  A 

LOOKUP  TURRETAZIMUTH 

Sec.  2.9.1 .1  See  Appendix  A 

range  sguared 

Sec.  2.14.3.5.10 

get  impact  and  trajectory 

Sec.  2.6.4.5.1 

simnet  send  impact 

MOMENTUM 

ENERGY 

Sec.  2.14.3.9  See  Appendix  A 

DEBUG  WEAPON 

Sec.  2.5.2.2  See  Appendix  A 

Table  2.6-473:  generate_weapon_hit  CSU  [8.6.9.8.24] 
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2.6.9.8.25  generate_weapon_iniss  CSU 

This  CSU  generates  a  weapon  miss.  The  symbolic  constant  MISS_FACTOR  is  defined 
before  this  CSU  (^define  MISS_FACTOR  10.0). 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

*safobi 

pointer  to  SAF  OBJECT 

Sec.  2.9.1. 1 

^weapon 

pointer  to  WEAPON  VARS 

Sec.  2.9.1. 2 

taroetlD 

unsigned  short 

Standard 

Calls 

Function 

1  Where  Described  1 

OBJ  VEHICLEID 

OBJ  POSITION 

LOOKUP  POSITION 

vec  copy 

Sec.  2.6.2.59.1  Vehicles  CSCI  SDD 

pet  me  a  random  fraction 

Sec.  2.14.3.7.1 

range  squared 

Sec.  2.14.3.5.10 

simnet  send  impact 

MOMENTUM 

ENERGY 

DEBUG  WEAPON 

Sec.  2.5.2.2  See  Appendix  A  I 

Table  2.6-474:  generate_weapon_miss  CSU  [8.6.9.8.25] 


2. 6. 9. 9  weapons.h  CSU 

/simnet/src/host/weapons.h 

This  CSU  contains  the  structure  definition  and  symbolic  constants  used  by  the  weapons 
code. 


Constant 

Value 

MAX  WEAPONS 

4 

WEAPON  STATE  NOT  SELECTED 

0 

WEAPON  STATE  SELECTING 

1 

WEAPON  STATE  SELECTED 

2 

WEAPON  STATE  LOADING 

3 

WEAPON  STATE  LOADED 

4 

WEAPON  STATE  UNLOADING 

5 

WEAPON  STATE  DESELECTING 

6 

ROUND  AWAY 

0 

ROUND  NOT  SHOT  BECAUSE  OF  NO  LOS 

1 

ROUND  NOT  SHOT  BECAUSE  OF  NO  LEAD 

2 

ROUND  IN  FLIGHT 

3 

ROUND  DONE  FLYING 

4 

MAX  WEAPONS  IN  REPORT 

(10*  MAX  WEAPONS) 

Table  2.6-475:  weapons.h  Constant  Definitions 
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The  following  typedef  struct  is  tagged  gun_burst_description. 


Item 

Type 

Where  Type  Defined 

burst  event  id 

int 

Standard 

taroetlD 

short 

Standard 

REAL 

Sim  types. h 

VECTOR 

Sim  types.h 

target  predicted  position 

VECTOR 

sim  types.h 

impact  time 

unsigned  int 

Standard 

is  going  to  hit 

int 

Standard 

Table  2.6-476:  GUN_BURST_DESCRIPTION  Structure  Derinition 
The  following  typedef  struct  is  tagged  weapon_status_data. 


Item 

Type 

Where  Type  Defined 

num  weapons 

int 

Standard 

•weapon  namesfMAX  WEAPONS  IN  REPORT! 

pointer  to  char 

Standard 

rounds  available/MAX  WEAPONS  IN  REPORTl 

int 

Standard 

max  roundsfMAX  WEAPONS  IN  REPORTl 

int 

Standard 

Table  2.6-477:  WEAPON  STATUS  DATA  Structure  Derinition 


2.6.9.10  loader.c  CSC 

/simnet/src/host/loader.c 

This  CCSC  does  the  selection  of  weapon  to  use  and  the  loading  and  unloading  of  rounds. 
Transition  times  between  rounds  and  weapon  selections  are  taken  into  account  by  this  code. 


loader.c 

CSC 

8.6.9.10 


loader 
CSU  8 


^ 

er_lick  ^ 

■6.9.10.1  J 


Figure  2.6-41:  loader.c  CSC  Structure 
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2.6.9.10.1  loader  tick  CSU 


This  CSU  selects  and  loads  the  chosen  weapon.  If  the  commander  changes  the  chosen 
weapon,  the  old  weapon  may  have  to  be  unloaded  or  unselected. 


1  Parameters  1 

Parameters 

Type 

Where  Typedef  Declared 

‘safobj 

pointer  to  SAF  OBJECT 

Sec.  2.9. 1.1 

1  Calls  1 

Function 

Where  Described 

weapon  select 

Sec.  2.6.9.8.14 

weapon  deselect 

Sec.  2.6.9.8.15 

OBJ  VEHICLEID 

Sec.  2.6.9.8.16 

■  weapon  unload 

Sec.  2.6.9.8.17 

Table  2.6-478:  loader_tick  CSU  [8.6.9.10.1] 
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2.7  REMOTE  VEHICLES  CSC 

Like  the  local  vehicles,  remote  vehicles  are  also  ticked  by  the  scheduler.  The  prim^ 
difference  is  that  the  locd  vehicles  are  simulated  by  the  simhost  and  the  remote  vehicles  are 
not.  The  function  of  the  renx>te  vehicles  code  is  to  maintain  an  internal  representation  of 
the  state  of  vehicles  which  are  simulated  by  other  computers  at  the  SIMNET  LAN.  These 
computers  can  be  other  SAF  computers  as  well  as  manned  vehicle  simulators  or  MCC 
vehicles. 

Remote  vehicles  broadcast  vehicle  ^pearance  packets  (VAP)  on  the  network  whenever 
their  state  changes  beyond  certain  tlmsholds.  The  SIM^T  interface  receives  these 
packets  and  queues  them  on  each  remote  vehicle.  When  the  remote  vehicle  is  ticked,  it 
updates  its  state  to  that  described  in  the  VAP.  In  some  cases,  the  remote  vehicle  code  will 
extrapolate  the  position  of  the  remote  vehicle  at  the  present  time  fix>m  that  received  in  the 
last  packet  By  representing  the  remote  vehicles  with  the  same  internal  interface  as  the  local 
vehicles,  it  is  not  necessaiy  for  a  SAF  vehicle  doing  targeting  to  distinguish  between  local 
and  remote  vehicles. 


Remote 

Vehicles 

CSC 

8.7 


remote.c 

CSC 


create  remote 

CSU  8.7.1. 1 

_ ^ 

remote  init  vars 

CSU  8.7.1. 2 

V 

r 

remote  show 

CSU  8. 7.1. 4 

remote_fill_echelon_data 
CSU  8.7.1. 7 


remote_start_being_ 
watched  CSU  8.7.1.10 


remotejick 
CSU  8.7.1.13 


remote_chango_stealth_ 
oontrolling_port 
CSU  8.7.1.16 


remote_start_ticking 
CSU  8.7.1 .5 


remote_fill_in _position_ 
data  CSU  8.7. 1.8 


remote_stop_being_ 
watched  CSU  8.7.1.11 


send_stealthjgono_msg 
CSU  8.7.1.14 


create_remote  vehicle 
CSU  8.7.i7i7 


remotejgo_away 
CSU  8.7.1.3 


remote_fillJn_appearance 
data  CSU  8.7. 1.6 


remote_next_road_point 
CSU  8.7.1. 9 


remote_new_appearance 
CSU  8.7.1.12 


remote_deactivate 
CSU  8.7.1.15 


Figure  2.7-1:  Remote  Vehicles  CSC  Structure 


434 


